Bevor du startest
- API-Key-Scope: Erfordert einen API-Schlüssel mit dem
KNOWLEDGE_FOLDER_APIScope. Der API-Schlüssel selbst benötigt die Rolle Bearbeiter für die Wissensdatenbank. Siehe Wissensdatenbank mit der API teilen für die Einrichtung.
Basis-URL
Anforderungsformat
Dieser Endpunkt akzeptiertmultipart/form-data Anfragen mit der angehängten Datei.
Pfadparameter
Formularfelder
Die Größenlimits hängen vom Dateityp ab: 10 MB für reinen Text, Markdown, JSON und VTT-Dateien, 30 MB für XML-Dateien und 256 MB für andere unterstützte Dokumenttypen. Eine Übersicht der unterstützten Formate findest du in der Referenz unterstützter Dateitypen.
Unterstützte Dateitypen
Wissensdatenbanken unterstützen Dokument- und Textformate wie:- PDF (
.pdf) - Word-Dokumente (
.doc,.docx) - Textdateien (
.txt) - Markdown (
.md) - HTML (
.html) - PowerPoint (
.pptx,.ppt)
Beispiele
Datei mit cURL hochladen
Datei mit JavaScript hochladen
Upload mit Quell-URL
Antwortformat
Erfolgreiche Antwort (200 OK)
Beispielantwort
Antwort bei fehlgeschlagener Dateivalidierung (400 Bad Request)
Wenn die Dateivalidierung fehlschlägt, findest du den Grund inmessage:
Fehlerbehandlung
Verarbeitungsstatus
Nach dem Upload wird die Datei asynchron verarbeitet. Verwende den Dateien abrufen Endpunkt, um den Verarbeitungsstatus zu prüfen. DassyncStatus Feld zeigt den aktuellen Zustand:
UPLOADING- Datei wird hochgeladenUPLOADED- Datei ist hochgeladen und in der WarteschlangeEXTRACTING- Text wird aus der Datei extrahiertEMBEDDING- Embeddings werden generiertSYNCED- Datei ist bereit für die SucheACTION_FAILED,EXTRACTION_FAILED,EMBEDDING_FAILED,TIMEOUT- Verarbeitung fehlgeschlagen
Asynchrone Upload-Variante
Für große Dateien oder wenn du nicht auf die Upload-Antwort warten musst, kannst du den asynchronen Upload-Endpunkt verwenden:multipart/form-data Felder und gibt 202 Accepted zurück, sobald die Datei empfangen wurde. Die Verarbeitung läuft im Hintergrund weiter.
400 Bad Request Antwort statt 202 Accepted zurück.
Nutze GET {statusUrl}, um den Verarbeitungsstatus abzufragen. Die Antwort gibt den aktuellen Status in result.syncStatus zurück.
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.