Skip to main content
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/public
Lädt eine neue Datei in eine bestimmte Wissensdatenbank hoch. Die Datei wird verarbeitet, eingebettet und für die semantische Suche verfügbar gemacht.
Erfordert 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 akzeptiert multipart/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)
Ausführbare Dateien und andere potenziell gefährliche Dateitypen werden aus Sicherheitsgründen blockiert.

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 in message:

Fehlerbehandlung

Verarbeitungsstatus

Nach dem Upload wird die Datei asynchron verarbeitet. Verwende den Dateien abrufen Endpunkt, um den Verarbeitungsstatus zu prüfen. Das syncStatus Feld zeigt den aktuellen Zustand:
  • UPLOADING - Datei wird hochgeladen
  • UPLOADED - Datei ist hochgeladen und in der Warteschlange
  • EXTRACTING - Text wird aus der Datei extrahiert
  • EMBEDDING - Embeddings werden generiert
  • SYNCED - Datei ist bereit für die Suche
  • ACTION_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:
Dieser Endpunkt akzeptiert die gleichen multipart/form-data Felder und gibt 202 Accepted zurück, sobald die Datei empfangen wurde. Die Verarbeitung läuft im Hintergrund weiter.
Die Dateivalidierung erfolgt, bevor die API den Upload akzeptiert. Wenn sie fehlschlägt, gibt der asynchrone Endpunkt die oben gezeigte 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.

Autorisierungen

Authorization
string
header
erforderlich

API key as Bearer token. Format "Bearer YOUR_API_KEY"

Pfadparameter

folderId
string
erforderlich

The ID of the knowledge folder

Body

multipart/form-data
file
file

The file to upload

url
string

The associated URL

Antwort

File uploaded successfully