Legg ved et bilde, en tegning eller en PDF

POST/api/v1/orders/{number}/attachments

Virker

multipart/form-data med fil og type. Typen leses fra filens første byte, ikke fra navnet.

Rettigheter: orders:write
Kundenøkkel: Ja, for sine egne
Grense: filer, 10 i minuttet
Siden: 5. oktober 2026

Parametre

I adressen

numberstringMå medhøyst 12 tegn
«4711», «004711», «T-000012» (testnøkler), eller et lappnummer som er blitt ordrens.

Overskrifter

Idempotency-Keystring8–255 tegn
8–255 tegn. Bruk en UUID per forsøk på en handling; samme nøkkel og samme innhold gir samme svar igjen.

Det du sender

multipart/form-dataAttachmentUploadMå med

filstring · binaryMå med
Filen: JPEG, PNG, WebP, HEIC eller PDF, høyst 15 MB. Typen leses fra filens første byte.
typestringMå med
foto, tegning eller pdf
Verdierfototegningpdf

Svaret

201CreatedFilen er lagret

application/jsonAttachment

idstring · uuidMå med
UUID
kindstringMå med
Verdierfototegningpdf
contentTypestringMå med
bytesintegerMå med
createdAtstring · date-timeMå medeks. 2026-12-14T09:03:00.000Z
Tidspunkt, ISO 8601 i UTC

Feilkoder

Alle feil har samme form. Velg handling etter code, aldri etter message. Les mer under Feil.

400Bad Request

invalid_requestNoe i forespørselen er feil eller ukjent. fields sier hva.

401Unauthorized

unauthorizedNøkkelen mangler, er feil, er slått av eller har gått ut. En nøkkel som slås av, slutter å virke innen 1 minutt.

403Forbidden

account_closedVerkstedet er stengt.
dpa_requiredVerkstedet må godta databehandleravtalen før koblinger kan brukes.
feature_not_in_planVerkstedet har ikke slått på delen dette trenger. feature sier hvilken.
insufficient_scopeNøkkelen har ikke lov til dette. requiredScope sier hvilken rett som mangler.

404Not Found

not_foundFant ikke dette.

409Conflict

idempotency_in_progressEn forespørsel med samme Idempotency-Key holder på. Prøv igjen om litt.
status_conflictOrdren kan ikke flyttes dit fra statusen den har nå. reason sier hvorfor.

413Payload Too Large

payload_too_largeFilen er for stor.

415Unsupported Media Type

unsupported_media_typeFiltypen tas ikke imot. Send JPEG, PNG, WebP, HEIC eller PDF.

422Unprocessable Entity

idempotency_key_reusedDenne Idempotency-Key ble brukt på en annen forespørsel. Bruk en ny nøkkel for ny handling.
too_many_attachmentsOrdren har allerede så mange filer som den kan ha.

429Too Many Requests

rate_limitedFor mange kall. Vent retryAfterSeconds sekunder.

500Internal Server Error

internalNoe gikk galt hos oss. Feilen er meldt. Oppgi requestId hvis du spør.

POST/orders/{number}/attachments

curl https://vbeslag.com/api/v1/orders/004711/attachments \
  -H "Authorization: Bearer vb_test_…" \
  -F fil=@skisse.jpg \
  -F type=foto

import { openAsBlob } from 'node:fs' // Node 20+

const form = new FormData()
form.append('fil', await openAsBlob('skisse.jpg'), 'skisse.jpg')
form.append('type', 'foto')

const res = await fetch('https://vbeslag.com/api/v1/orders/004711/attachments', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer vb_test_…',
  },
  body: form,
})
const data = await res.json()

$ch = curl_init('https://vbeslag.com/api/v1/orders/004711/attachments');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST  => 'POST',
    CURLOPT_HTTPHEADER     => [
        'Authorization: Bearer vb_test_…',
    ],
    CURLOPT_POSTFIELDS     => ['fil' => new CURLFile('skisse.jpg'), 'type' => 'foto'],
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);

Svaret

HTTP/1.1 201 Created
Content-Type: application/json

{
  "id": "6fcbc93f-bc8d-4b8f-a1c5-f08647b0754c",
  "kind": "foto",
  "contentType": "image/jpeg",
  "bytes": 284123,
  "createdAt": "2026-12-14T09:03:00.000Z"
}