Crator API for udviklere
Crators External API lader din webshop, B2B-portal eller dit eget system arbejde direkte med virksomhedens regnskab: hent kunder og deres egne priser, send ordrer ind, følg status og hent fakturaer — med signerede webhooks, når noget ændrer sig.
Kom i gang
Virksomhedens ejer opretter en API-nøgle under Indstillinger → API-nøgler og vælger nøglens rettigheder (læse, skrive, webhooks). Nøglen sendes som Authorization: Bearer crator_… på hvert kald.
Alle svar har samme form: { ok: true, data } eller { ok: false, error, code }. Byg din logik på den stabile code, ikke på den danske fejltekst.
Hvad API'et kan
API'et er bygget til at Crator er master for kunder, priser, ordrer, fakturaer og lager — din integration læser derfra og sender ordrer ind.
- Kunder med rabataftaler og kundens nettopriser pr. vare
- Ordrer ind i ordreflowet — idempotent på din egen reference
- Fakturaer, kreditnotaer, PDF og registrering af betalinger
- Signerede webhooks for ordre- og fakturastatus, med leveringslog til genindhentning
- Paginering og updatedSince til natlige synkroniseringer
Stabilitet og versionering
/v1 er kun additiv: felter fjernes eller skifter aldrig type. Nye felter, endpoints og enum-værdier kan komme til, så din kode skal ignorere værdier, den ikke kender. En brydende ændring betyder en ny /v2.
Kald er begrænset til 600 pr. minut pr. nøgle, heraf 60 skrivende. Over grænsen svarer API'et 429 med Retry-After.
Reference
Referencen nedenfor genereres direkte fra API'ets egne valideringsskemaer (OpenAPI 3.1), så den altid følger det, API'et faktisk accepterer. Du kan også hente specifikationen som JSON og generere en klient ud fra den.