- Dokumentasjon
- Drift
Migrering fra v0
Det uversjonerte v0-API-et slås av 1. desember 2026. Alt som er endret, endepunkt for endepunkt, og en plan for å komme over på to dager.
API-et på /v0 var Spires første, fra 2023. Det slås av 1. desember 2026. Alle kunder som har brukt det siste 90 dager har fått e-post. Denne siden lister alt som er endret.
Oversikt
| v0 | v1 (2026-09-01) |
|---|---|
https://api.spireapi.com/v0/… | https://api.spireapi.com/v1/… med Spire-Version: 2026-09-01 |
Nøkkel i X-Api-Key | Authorization: Bearer … |
Feil som { "error": "tekst" } | { "feil": { "kode", "melding", "felt", "dok", "request_id" } } |
Offset-paginering (?side=2) | Markør (?markor=…) |
| Webhooks uten signatur | HMAC-signatur i Spire-Signature |
| Engelske feltnavn blandet med norske | Konsekvent norsk |
Endepunkt for endepunkt
Virksomheter
| v0 | v1 |
|---|---|
GET /v0/companies/{orgnr} | GET /v1/virksomheter/{orgnr} |
GET /v0/companies?q= | GET /v1/virksomheter?sok= |
GET /v0/companies/{orgnr}/roles | GET /v1/virksomheter/{orgnr}/roller |
GET /v0/companies/{orgnr}/financials | GET /v1/virksomheter/{orgnr}/regnskap |
Feltnavn: name → navn, orgForm → organisasjonsform, address → forretningsadresse, employees → ansatte, vatRegistered → mva_registrert. Roller returneres nå som strukturert objekt, ikke flat liste. personnummer fantes aldri, men birthDate er fjernet til fordel for fodselsaar.
Fakturaer
| v0 | v1 |
|---|---|
POST /v0/invoices (opprettet og sendte i ett) | POST /v1/fakturaer + POST /v1/fakturaer/{id}/send |
GET /v0/invoices/{id} | GET /v1/fakturaer/{id} |
POST /v0/invoices/{id}/credit | POST /v1/fakturaer/{id}/kreditnota |
Største endring: opprett og send er to steg. Det gir deg mulighet til å vise fakturaen før sending. Vil du ha gammel oppførsel, send send: true i kroppen ved opprettelse.
Linjer: description → tekst, quantity → antall, unitPrice → pris, vatRate → mva. Beløp i v0 var i øre som heltall; i v1 er de desimaltall i kroner.
Meldinger
| v0 | v1 |
|---|---|
POST /v0/sms | POST /v1/meldinger med kanaler: ["sms"] |
POST /v0/email | POST /v1/meldinger med kanaler: ["epost"] |
Webhooks
v0-webhooks hadde ingen signatur og én fast URL per konto. v1 har signatur, opptil 20 URL-er med hvert sitt hendelsesfilter, og leveringslogg. Registrer webhooks på nytt i v1; v0-webhooks migreres ikke automatisk fordi hendelsesformatet er endret.
Hendelsesnavn: invoice.paid → faktura.betalt, company.changed → virksomhet.endret, og så videre. Full liste i referansen.
Plan for migrering
Dag 1, formiddag. Opprett v1-nøkler i dashbordet. Installer SDK (anbefalt; v0 hadde ikke SDK). Kjør eksisterende tester mot sandkassen med v1 og se hva som brekker.
Dag 1, ettermiddag. Bytt feltnavn og feilhåndtering. Feilhåndtering er typisk den største jobben, fordi v0 bare ga tekst.
Dag 2, formiddag. Registrer v1-webhooks med signaturverifisering. Kjør begge sett webhooks parallelt i produksjon i en uke; ignorer v0 når v1 er bekreftet.
Dag 2, ettermiddag. Rull ut. Behold v0-nøkkelen i to uker som nødbrems, slett den deretter.
Trenger dere mer tid eller hjelp, ta kontakt. Vi har hjulpet 40 kunder over, og de fleste bruker under tre dager.