Konvensjoner

Over hele API-et

Base-URL

Alle ruter ligger under https://api.skribb.no/v1. Du kaller aldri publikasjonens eget domene.

Autentisering

Authorization: Bearer skribb_sk_… på hver forespørsel. Ingen sesjon, ingen informasjonskapsel.

Publikasjon

Nøkkelen bestemmer hvilken publikasjon du når. Du oppgir den ikke som parameter.

Feltnavn

snake_case og engelsk, både inn og ut.

Penger

Heltall i øre, alltid NOK. kr 249,00 er 24900.

Tidspunkter

ISO 8601 i UTC, for eksempel 2026-07-26T09:12:00.000Z. Gjelder hvert tidsfelt.

Beskjed når noe skjer

Legg inn en webhook under Innstillinger, så sender vi en signert POST når noe skjer.

Gjentatte forsøk

Sender du Idempotency-Key på en POST som oppretter noe, husker vi svaret i et døgn. Kommer forespørselen på nytt fordi svaret gikk tapt, får du det samme svaret tilbake i stedet for en ny kopi. Velg en ny nøkkel per forespørsel, ikke per forsøk.

Paginering

Lister svarer med has_more og next_cursor ved siden av radene. Er has_more sann, sender du next_cursor som ?cursor= for å få neste side. Cursoren er ugjennomsiktig: den peker på raden du sist så, så nye rader som kommer til mens du blar, verken hopper over eller gjentar noe.

Body

Content-Type: application/json på alt du sender. Uten den blir bodyen ikke lest, og du får «empty-update» i stedet for det du ventet.

Delvis endring

PATCH rører bare feltene du sender. Resten står. Sender du ingen av dem, svarer vi 422 empty-update. PUT-ruter tar hele lista.

Ut til publikasjonen

Endringer du gjør her, går ut til publikasjonen med det samme. Når vi ikke når fram, står de lagret og går ut ved neste lagring.

Grenser