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.
Adresser
Section titled “Adresser”| 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.
Modellen: person, firma, oppdrag, selskap
Section titled “Modellen: person, firma, oppdrag, selskap”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.
Hva du kan stole på
Section titled “Hva du kan stole på”- 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, ikke403. Du lærer ikke at et selskap finnes uten å ha tilgang til det.
Stabilitet
Section titled “Stabilitet”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.
Hvor begynner du?
Section titled “Hvor begynner du?”| 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.