API-dokumentation

Hele Mero er bygget på ét API.

Appen, du klikker i, taler med præcis det samme API, som integratorer får adgang til. Kontrakten er en OpenAPI-specifikation, der håndhæves i CI: kan et endpoint ikke findes i spec'en, fejler builden.

På vej Det offentlige API åbner sammen med de første eksterne integrationer. Fra den dag versioneres der med /v1 og mindst 6 måneders varsel ved ændringer.

Autentificering

Scopede nøgler, vist én gang.

API-nøgler starter med mero_, vises præcis én gang og opbevares kun som hash.
Hver nøgle får kun de rettigheder, du giver den, som invoices:read eller reports:read, og kan sættes til at udløbe automatisk.
Kun administratorer kan udstede nøgler, og de kan trækkes tilbage med det samme.
Vejledende grænser: 120 kald i minuttet generelt, 10 i minuttet for tunge kald som rapporter og eksport.

eksempel · endelig host følger med det offentlige API

# Hent fakturaer
curl https://api.mero.dk/v1/invoices \
  -H "X-Api-Key: mero_****************"

# Svar
{
  "data": [{
    "invoice_number": "2026-0087",
    "contact": "Kunde A",
    "total": "450.00",
    "currency": "DKK",
    "status": "sent"
  }]
}

Overfladen

Det, API'et allerede kan i dag.

Godt 230 endpoints driver produktet lige nu. Her er de vigtigste grupper, som de ser ud i den interne kontrakt.

MetoderRessourceBeskrivelse

GETPOST/invoicesFakturaer, kreditnotaer og betalinger.

GETPOST/journal-entriesPosteringer: kladde, forhåndsvisning, bogfør og tilbagefør.

GETPOST/documentsBilag ind, tekstudtræk og AI-forslag ud, klar til godkendelse.

GET/vat-returnsMomsopgørelser og SKAT-kalender.

GETPOST/bank-accountsBankkonti, import af udtog og afstemningsforslag.

GET/reports/…Resultat, balance, råbalance, kontokort, likviditet og aldersfordelt debitor.

GET/saft/exportHele regnskabet ud som dansk SAF-T 2.0, valideret mod den officielle standard.

GET/vatin/verifyValidering af momsnumre, med opslag i EU's VIES-register.

POST/webhooksAbonnér på hændelser med signerede leveringer og automatiske gentagelser.

POSTDEL/api-keysUdsted og tilbagekald scopede maskinnøgler.

Kontrakten er lov

Spec'en genereres fra koden, og CI fejler, hvis et endpoint mangler i den eller omvendt. Dokumentationen kan ikke drive fra virkeligheden.

Typet klient

Meros egen frontend bruger en TypeScript-klient genereret fra samme spec, med automatisk driftkontrol. Den bliver grundlaget for et offentligt SDK.

Ingen overraskelser

Når /v1 åbner, gælder en fast politik: ændringer, der kan mærkes, varsles mindst 6 måneder i forvejen.

Bygger du noget, der skal tale med Mero?

Vi åbner API'et sammen med de første integrationspartnere. Skriv, hvad du vil bygge, så tager vi en snak.

Skriv til hej@mero.dk