Hopp til innhold
skribbskribb

Utviklere

Konvensjoner

Dette gjelder over hele API-et, uansett hvilken rute du kaller.
Alle sidene

Referanse

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. Det er konvensjonen klientbibliotekene dine forventer.
Penger
Heltall i øre, alltid NOK. kr 249,00 er 24900. Vi regner aldri med desimaltall.
Tidspunkter
ISO 8601 i UTC, for eksempel 2026-07-26T09:12:00.000Z. Det gjelder hvert tidsfelt, så du slipper å gjette på sone.
Beskjed når noe skjer
Du trenger ikke spørre på en timer. Legg inn en webhook under Innstillinger, så sender vi en signert POST når noe skjer. Se avsnittet lenger nede.
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.

Grenser

Rategrense

Rundt 120 forespørsler i minuttet per nøkkel, og strammere for forespørsler uten gyldig nøkkel. Går du over, svarer vi 429 med Retry-After. Tallet er omtrentlig: grensa telles der forespørselen din lander i nettet vårt, så en integrasjon spredt over flere verdensdeler får litt mer. Vi sender ingen teller for hvor mye du har igjen.

Innlegg har ikke cursor

Produkter, bestillinger og abonnenter har cursor. Innlegg har ikke, fordi de ligger på publikasjonen din og hentes gjennom en annen vei. Lista gir alt på én gang.

Markdown er en visning, ikke fasiten

Du kan skrive og lese Markdown, men publikasjonen lagrer Portable Text. Har innlegget en betalingsmur, en nivåsperre eller et abonnent-kort, finnes de ikke i Markdown, og lesingen sier fra om hva som ikke ble med. Skal du endre et innlegg uten å miste noe, gå via content.

Abonnenter kan bare leses

Abonnentlista er skrivebeskyttet. Påmelding skal gjennom den vanlige bekreftelsen, så en lekket nøkkel ikke kan bli en spamliste.

Publiserer du et innlegg som aldri har vært publisert, går nyhetsbrevet ut til abonnentene. Å publisere et innlegg som alt er sendt, sender ikke på nytt, men behandle likevel publisering som en handling du gjør bevisst.