Gå til innholdet

Introduksjon

Nettet er produktet, og API-et er plattformen. Alt portalen gjør, gjør den over det samme API-et du kaller selv. Et menneske og en integrasjon treffer de samme endepunktene med de samme reglene, og det finnes ingen bakdør for noen av dem. Kommandolinjen (regnmed) er for drift og administrasjon, og er aldri eneste vei til en funksjon.

Hva Adresse
API https://api.regnmed.no
Identitetstilbyder (regnid) https://id.regnmed.no
Portal https://regnmed.no
Åpen forankringsfeed https://api.regnmed.no/anchors

Portalen og API-et serveres av samme binær, så https://regnmed.no svarer også på API-stiene. Bruk api.regnmed.no i integrasjoner.

person ──medlem av──▶ firma (regnskapsfører / revisor)
│ │
│ └── oppdrag (omfang + gyldighet) ──▶ selskap
└──direkte medlem (rolle)────────────────────────────────▶ selskap
  • En person er en identitet fra regnid. Et menneske og en robot er begge personer.
  • Et selskap eier en hovedbok. All tilgang går til et selskap.
  • Et firma er et regnskaps- eller revisjonsbyrå. Det får tilgang til selskaper gjennom oppdrag (avtale med omfang og gyldighetsperiode), ikke gjennom en liste i tokenet.
  • Tilgangen din er union av alle veier inn: direkte medlemskap med en rolle, oppdrag via et firma, og for en maskin et tildelt rollenavn.

Hovedregelen er: tokenet beviser identitet, regnmed avgjør hva identiteten får gjøre. Tilgangen ligger i regnmeds database, aldri i tokenet. Se Tilgang og roller.

  • Beløp er heltall øre, aldri flyttall. Positivt er debet, negativt er kredit.
  • Hovedboken er append-only. Rettelser er reverserende bilag. Du kan verifisere kjeden selv, se Verifiser selv.
  • Ingen tilgang gir 404, ikke 403. Du lærer ikke at et selskap finnes uten å ha tilgang til det.

Endepunktene i API-referansen brukes av portalen og regnes som stabile. Felter kan komme til. Eksisterende felter fjernes eller endrer betydning bare med et varsel i CHANGELOG og en overgangsperiode. Nye endepunkter dukker opp med hver sak i ROADMAP. Responsene har ingen versjonsprefiks i dag.

JSON-feltene er delvis norske, fordi nettformatet er eldre enn språkpolicyen (orgnr, termin, leveringsdato, prosjekt). Eksemplene i denne dokumentasjonen bruker nøklene akkurat slik de står på tråden.

Du vil … Les
Kalle API-et fra et script eller en nettbutikk Kom i gang
Forstå token, aud og klientregistrering Autentisering
Gi en robot riktig tilgang Tilgang og roller
Se hvordan beløp, datoer og feil ser ut Konvensjoner
Kopiere ferdige kall Eksempler
Slå opp et endepunkt API-referanse
Gi en LLM-agent verktøy MCP og agenter
Kontrollere at hovedboken ikke er rørt Verifiser selv
Kjøre regnmed selv Selvhosting
Bidra til koden Bidra

Revisjonsvendt dokumentasjon om hva systemet garanterer og hvor det testes, ligger under Teknisk dokumentasjon.