Zum Hauptinhalt springen
Erstellt eine Wissensdatenbank und gibt diesem API-Schlüssel die Rolle Bearbeiter. Nutze die zurückgegebene ID, um Dateien hochzuladen, die Wissensdatenbank umzubenennen oder Zugriff zu teilen. Persönliche API-Schlüssel können keine Wissensdatenbank erstellen.

Bevor du startest

  • API-Key-Scope: Erfordert einen Workspace-API-Schlüssel mit dem KNOWLEDGE_FOLDER_API Scope. Ein Schlüssel, der diesen Scope schon hat, kann diesen Endpoint aufrufen. Persönliche Schlüssel werden auch mit diesem Scope abgelehnt. Der Besitzer des Schlüssels braucht die Berechtigung Dateien hochladen. Siehe Wissensdatenbanken mit der API teilen für die Einrichtung.
  • Wissensdatenbanken: Die Knowledge Folder API verwaltet Ressourcen, die in der Library als Wissensdatenbanken erscheinen.

Basis-URL

Dedicated DeploymentsErsetze api.langdock.com durch <your-deployment-url>/api/public in allen Anfragen.

Anfrageformat

Dieser Endpoint akzeptiert application/json.

Request Body

Unbekannte Felder werden abgelehnt. Es gibt keinen öffentlichen Endpoint, um eine Wissensdatenbank zu löschen.

Beispiele

Erstellen mit cURL

Erstellen mit JavaScript

Antwortformat

Erfolgreiche Antwort (201 Created)

role ist EDITOR, und fileCount ist 0. Du kannst Dateien hochladen, aktualisieren und löschen, die Wissensdatenbank umbenennen und Zugriff teilen, ohne sie vorher mit dem Schlüssel zu teilen.

Beispielantwort

Fehlerbehandlung

Ein leerer Name, ein Feld über 2000 Zeichen oder ein unbekanntes Feld liefert 400 mit "Invalid request". Ein persönlicher Schlüssel liefert 403 mit "This API key cannot create knowledge folders." Fehlt dem Besitzer Dateien hochladen, ist die Antwort 403 mit "This API key's owner does not have permission to upload documents." Fehlt der Scope, ist die Antwort 403 mit error INSUFFICIENT_SCOPES.
Langdock blockiert bewusst Browser-basierte Anfragen, um deinen API-Schlüssel zu schützen und die Sicherheit deiner Anwendungen zu gewährleisten. Weitere Informationen findest du in unserem Guide zu Best Practices für API-Schlüssel.