Kom i gang

Denne guiden tar deg gjennom det første kallet mot Spire. Du trenger en konto, en testnøkkel og en terminal eller et av SDK-ene.

1. Opprett konto og hent en testnøkkel

Opprett en konto i dashbordet. Du får med en gang et sandkassemiljø med en nøkkel som begynner med sk_test_. Nøkkelen vises én gang; kopier den til et sikkert sted, for eksempel en miljøvariabel.

export SPIRE_NOKKEL=sk_test_din_nokkel_her

Testnøkler virker bare mot https://sandkasse.spireapi.com. Produksjonsnøkler (sk_live_) får du når du har lagt inn betalingskort, og de virker bare mot https://api.spireapi.com. De to miljøene deler aldri data.

2. Gjør det første kallet

Hent en virksomhet fra sandkassens datasett. Sandkassen har hele det norske virksomhetsregisteret som det så ut 1. oktober 2026, pluss noen oppdiktede testselskaper for hjørnetilfeller.

curl https://sandkasse.spireapi.com/v1/virksomheter/923456789 \
  -H "Authorization: Bearer $SPIRE_NOKKEL"

Svaret kommer som JSON:

{
  "orgnr": "923456789",
  "navn": "Tallgruppen AS",
  "organisasjonsform": "AS",
  "naering": { "kode": "69.201", "tekst": "Regnskap og bokføring" },
  "forretningsadresse": { "adresselinje": "Strandgaten 18", "postnummer": "5013", "poststed": "Bergen" },
  "status": "aktiv"
}

Legg merke til hodet Spire-Request-Id i svaret. Det er nøkkelen til alt: oppgi den til support, slå den opp i dashbordet, eller lagre den i din egen logg.

3. Bruk et SDK

Du kan bruke API-et direkte, men SDK-ene gir deg typer, gjenforsøk, paginering og idempotens gratis.

npm install @spire/sdk        # Node
pip install spire-sdk         # Python
go get github.com/spireapi/spire-go/v2
dotnet add package Spire.Sdk
composer require spireapi/spire-php

Samme kall i Node:

import Spire from '@spire/sdk';

const spire = new Spire(process.env.SPIRE_NOKKEL); // sk_test_ → sandkasse automatisk
const v = await spire.virksomheter.hent('923456789');
console.log(v.navn); // Tallgruppen AS

SDK-et ser på nøkkelen og velger riktig miljø. Du bytter til produksjon ved å bytte nøkkel, ingenting annet.

4. Velg API-versjon

Spire er datoversjonert. Uten hodet Spire-Version får du versjonen som var gjeldende da kontoen ble opprettet, og den endres aldri uten at du ber om det. Sett den likevel eksplisitt, så er koden din tydelig:

Spire-Version: 2026-09-01

Les mer under versjonering.

5. Sett opp en webhook

De fleste integrasjoner trenger å vite når noe skjer: en faktura betales, et dokument signeres, et selskap går konkurs. Registrer en URL, og Spire sender hendelser dit:

curl -X POST https://sandkasse.spireapi.com/v1/webhooks \
  -H "Authorization: Bearer $SPIRE_NOKKEL" \
  -H "Content-Type: application/json" \
  -d '{ "url": "https://din.app/spire", "hendelser": ["*"] }'

Svaret inneholder hemmelighet, som du bruker til å verifisere at hendelsene faktisk kommer fra oss. Guiden om webhooks viser hvordan.

Neste steg

• Sandkassen: hva som er ekte data, hva som er simulert, og hvordan du utløser hjørnetilfeller.
• Autentisering: nøkler, rettigheter, miljøer og rotasjon.
• Feilhåndtering: feilformatet og hva du bør gjenforsøke.
• Produktguidene for Oppslag, Faktura, Signering, Varsling og Adresse.