Utviklere

Hurtigstart

Fra avgrenset nøkkel til første forespørsel, paginerte resultater, en køet import og mottak av endringer.

1. Opprett en avgrenset nøkkel

I Innstillinger → API-nøkler, opprett en nøkkel med bare omfanget du trenger (start med items:read), kopier hemmeligheten én gang, og legg den i en hemmelighetsforvalter — aldri i kode, URL-er eller nettleser-JavaScript.

export ITEMRA_API_KEY="itemra_live_replace_me"

2. Første forespørsel

curl -sS "https://api.itemra.io/v1/items?limit=10&sort=name" \
  -H "Authorization: Bearer $ITEMRA_API_KEY"

Samlinger returnerer data pluss page; send page.nextCursor som neste forespørsels cursor til den er uttømt.

3. Første skriving — med idempotens

curl -sS -X POST "https://api.itemra.io/v1/stock/adjustments" \
  -H "Authorization: Bearer $ITEMRA_API_KEY" \
  -H "Idempotency-Key: adj-2026-08-30-001" \
  -H "Content-Type: application/json" \
  -d '{ "sourceStockRecordId": "…", "direction": "down", "delta": 2, "reason": "damaged" }'

Idempotency-Key er påkrevd på skrivinger — velg en stabil ID per logisk operasjon og gjenbruk den bare for eksakte nye forsøk.

4. Kø en CSV-import

curl -sS "https://api.itemra.io/v1/imports/kinds" \
  -H "Authorization: Bearer $ITEMRA_API_KEY"

curl -sS -X POST "https://api.itemra.io/v1/imports/jobs" \
  -H "Authorization: Bearer $ITEMRA_API_KEY" \
  -H "Idempotency-Key: item-import-20260830-001" \
  -F "kind=items" -F "duplicateStrategy=create-only" \
  -F "file=@items.csv;type=text/csv"

Poll Location-URL-en fra svaret; barneruten /errors returnerer stabile feilkoder per rad etter fullføring.

5. Motta endringer

Foretrekk webhooks for push; der dere ikke kan motta, poll hendelsesstrømmen med events:read. For typede klienter og Postman, hent SDK-settet. Ved 429, respekter Retry-After; ta vare på traceId fra enhver feil dere rapporterer.