Prøv gratis

Med ReAI sitt offentlige API kan en virksomhet koble regnskapet til egne systemer, interne verktøy og AI-agenter. API-et bruker HTTPS, JSON og Bearer-token, og den maskinlesbare kontrakten finnes i ReAI OpenAPI .

Hva kan integreres?

API-et dekker blant annet:

  • Kunder, leverandører, produkter, fakturaer og ordre.
  • Leverandørfakturaer, bilag, posteringer og vedlegg.
  • Kontoplan, hovedbok og kunde-, leverandør- og ansattreskontro.
  • Bankkontoer, banktransaksjoner og bankavstemming.
  • Prosjekter, avdelinger, timer, utlegg og lønnsbetalinger.
  • MVA, skattemelding, eiendeler, lån og åpningsbalanse.

Tilgjengelige operasjoner og felter utvikles over tid. Bruk derfor OpenAPI som sannhetskilde når du bygger en integrasjon, fremfor å kopiere en statisk liste med endepunkter.

API-nøkler og tilgang

En bruker-API-nøkkel er standardvalget. Den har samme tilgang som brukeren, kan arbeide med alle selskapene brukeren har tilgang til og gjør at API-endringer kan knyttes til brukeren som eier nøkkelen. Integrasjonen bruker GET /api/me for å finne tilgjengelige tenants og sender X-Tenant-Id på tenant-spesifikke kall.

En tenant-API-nøkkel er bundet til ett selskap og kan avgrenses med scopes. Velg den når du vet at en permanent integrasjon skal begrenses til bestemte data og operasjoner i én virksomhet.

Opprett separate nøkler for separate integrasjoner, gi bare nødvendige tilganger, og regenerer eller slett en nøkkel som ikke lenger brukes.

Bygg mot den faktiske kontrakten

Et enkelt API-kall ser slik ut:

GET /api/chart-of-accounts HTTP/1.1
Host: app.reai.no
Authorization: Bearer <token>
X-Tenant-Id: <tenant-id>

OpenAPI beskriver obligatoriske felter, validering, HTTP-statuskoder og application/problem+json-feil. Integrasjonen bør kontrollere responsen, håndtere konflikt og valideringsfeil eksplisitt og lese objektet på nytt etter en endring.

AI-agenter og agentisk regnskap

Codex, Claude Code og andre agenter som kan bruke terminal og HTTPS kan arbeide direkte mot API-et. Start med guiden slik setter du opp en AI-agent for regnskap i ReAI . Der finner du samlet oppsett av nøkkel, miljøvariabler, arbeidsmappe, OpenAPI og første sikre kall.

For integrasjoner som kan endre regnskapet bør du også bruke en kontrollert arbeidsmetode med godkjenning og verifisering .

Før produksjonsbruk

  • Test lesekall før du gir skrivetilgang.
  • Bruk en avgrenset tenant og et kontrollert datasett.
  • Unngå duplikater ved å søke etter eksisterende objekter før opprettelse.
  • Logg objekt-ID-er og resultater, men aldri tokenet.
  • Krev menneskelig godkjenning for betaling, innsending, reversering og periodestenging.
  • Verifiser regnskapsmessig effekt, ikke bare HTTP-status.

Se også ReAI sine ferdige integrasjoner hvis du ikke trenger å bygge koblingen selv.