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.
Beispiele
Aktualisieren mit cURL
Aktualisieren mit JavaScript
Aktualisieren mit Quell-URL
Antwortformat
Erfolgreiche Antwort (200 OK)
Beispielantwort
Antwort bei fehlgeschlagener Dateivalidierung (400 Bad Request)
Wenn die Validierung der Ersatzdatei fehlschlägt, findest du den Grund inmessage:
Fehlerbehandlung
Verarbeitungsstatus
Nach der Aktualisierung wird die neue 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 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
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.