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
Du nutzt unsere API in einem Dedicated Deployment? Ersetze einfach
api.langdock.com durch die Base URL deines Deployments: <deployment-url>/api/publicErfordert einen API-Schlüssel mit dem
KNOWLEDGE_FOLDER_API Scope. Der API-Schlüssel selbst benötigt die Rolle Bearbeiter für die Wissensdatenbank. Siehe Wissensdatenbank mit der API teilen für die Einrichtung.Anforderungsformat
Dieser Endpunkt akzeptiertmultipart/form-data Anfragen mit der angehängten Datei.
Pfadparameter
Formularfelder
Unterstützte Dateitypen
Wissensdatenbanken unterstützen folgende Dokumenttypen:- 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.