Upload a file to a knowledge folder
Knowledge Folder API
Datei in eine Wissensdatenbank hochladen
Lade eine neue Datei in eine Wissensdatenbank hoch
POST
Upload a file to a knowledge folder
Lädt eine neue Datei in eine bestimmte Wissensdatenbank hoch. Die Datei wird verarbeitet, eingebettet und für die semantische Suche verfügbar gemacht.
Dieser Endpunkt akzeptiert die gleichen
Die Dateivalidierung erfolgt, bevor die API den Upload akzeptiert. Wenn sie fehlschlägt, gibt der asynchrone Endpunkt die oben gezeigte
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.