Upload bijlage-API

Upload bestanden die in Assistant-gesprekken kunnen worden verwijzen met hun attachment-ID's.

Om de API te gebruiken heb je een API-sleutel nodig. Je kunt API-sleutels aanmaken in je Workspace-instellingen: https://app.langdock.com/settings/workspace/products/api

cURL

cURL

curl --request POST \
  --url https://api.langdock.com/attachment/v1/upload \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: multipart/form-data' \
  --form file='@example-file'

Node (axios + form-data)

Verzoek

Dit endpoint accepteert multipart/form-data-aanvragen met een enkele bestandsupload.

• Methode: POST

• Pad: /attachment/v1/upload

• Content-Type: multipart/form-data

Header

• Authorization (string, vereist) — API-sleutel als Bearer-token. Formaat: "Bearer YOUR_API_KEY"

Body

• file (file, vereist) — Het bestand om te uploaden

Respons

200 application/json — Bestand succesvol geüpload

Response JSON:

response.json

{
  "attachmentId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "file": {
    "name": "<string>",
    "mimeType": "<string>",
    "sizeInBytes": 123
  }
}

Veldgegevens:

attachmentId

• Type: string (uuid)

• Vereist: ja

• Beschrijving: Unieke identifier voor de geüploade bijlage

file

• Type: object

• Vereist: ja

Onderliggende attributen:

• file.name — string, vereist — Originele bestandsnaam

• file.mimeType — string, vereist — MIME-type van het bestand

• file.sizeInBytes — integer, vereist — Grootte van het bestand in bytes

Voorbeeldgebruik

• Gebruik de geretourneerde attachmentId in de Assistant-API door deze op te nemen in de attachmentIds array op assistant-niveau of berichtniveau.

Foutafhandeling

Voorbeeld (Node.js)

error-handling.js

try {
  const response = await axios.post('https://api.langdock.com/attachment/v1/upload', ...);
} catch (error) {
  if (error.response) {
    switch (error.response.status) {
      case 400:
        console.error('Geen bestand meegezonden');
        break;
      case 401:
        console.error('Ongeldige API-sleutel');
        break;
      case 500:
        console.error('Serverfout');
        break;
    }
  }
}

Mogelijke statuscodes:

• 400 — Geen bestand meegezonden

• 401 — Ongeldige API-sleutel

• 500 — Serverfout