Oversikt og autentisering

Lese-API-et v1 bor på organisasjonens eget domene — alle endepunkter ligger under https://{din-org}.leidang.app/api/v1/. Det er med vilje skrivebeskyttet: integrasjonsgrunnlaget for å hente lagerdata inn i andre systemer, ikke en skrivekanal.

Nøkler

Opprett nøkler under Admin → API-nøkler (krever planfunksjonen api_access). En nøkkel vises én gang ved opprettelse — den lagres hashet og kan ikke hentes frem igjen, bare trekkes tilbake og utstedes på nytt. Hver nøkkel bærer lese-scopene du gir den (for eksempel items.view, stock.view); økonomifelter dukker opp i svarene bare når nøkkelen også har economy.view.

Forespørsel

curl https://din-org.leidang.app/api/v1/items?status=active \
  -H "Authorization: Bearer ldg_XXXXXXXXXXXXXXXX"

Paginering

Listeendepunkter returnerer opptil limit rader (1–200, standard 50), sortert på id.
Et svar med flere rader tilgjengelig bærer nextCursor — send den tilbake som ?cursor= for å fortsette. Mangler nextCursor, har du alt.
updatedSince (ISO-8601) gjør enhver liste til en inkrementell synk-strøm.

Feil

Feil er JSON med en lesbar melding. 401 — manglende, feilformet, ukjent eller tilbaketrukket nøkkel (svaret bærer WWW-Authenticate: Bearer); 403 — nøkkelen mangler scopet endepunktet krever; 400 — et filter du sendte er ugyldig, med årsaken forklart.

Behandle nøkler som passord: kun server-side, én nøkkel per integrasjon, trekk tilbake det du slutter å bruke.