GET/api/v1/meta

Vad den här installationen är och vad din nyckel får göra

I en självhostad modell kör varje kund sin egen version. Utan ett upptäcktsanrop måste integratören gissa vad installationen kan — det här svaret säger det i stället. Rutten kräver ingen särskild behörighet utöver en giltig nyckel, eftersom en nyckel annars inte skulle kunna ta reda på vad den själv får göra. Den dubbeltjänar som "testa nyckeln": ett 200 här betyder att nyckeln lever.

Din installations adress

Debet & Kredit kör på din egen server, så bas-URL:en är din — inte vår. Skriv in den här, så byts den ut i varje kodexempel i dokumentationen.

GET https://din-installation.se/api/v1/meta

Behörighet

Varje giltig nyckel

Takt

600 anrop per timme och nyckel (ställbart per nyckel).

Svar

Exempel på svar:

{
  "api_version": "v1",
  "schema_version": 1,
  "app_version": "0.1.0",
  "installation_schema_version": 112,
  "key": {
    "name": "Webshoppen",
    "scopes": [
      "data:read",
      "intake:write"
    ]
  },
  "fiscal_years": [
    {
      "year": 2026,
      "start": "2026-01-01",
      "end": "2026-12-31",
      "status": "open"
    }
  ],
  "period_locked_to": "2026-03-31",
  "vat_due_date": "2026-05-12",
  "endpoints": [
    {
      "method": "GET",
      "path": "/api/v1/verifikat",
      "scope": "data:read"
    }
  ]
}

Statuskoder

Kod	error	Betydelse
200	—	Installationens uppgifter och nyckelns behörigheter.
401	`unauthorized`	Saknad, felformad eller okänd nyckel.
401	`key_revoked`	Nyckeln är återkallad av installationens ägare.
429	`rate_limited`	Nyckelns kvot för timmen är förbrukad. Retry-After säger när den återställs.
503	`server_misconfigured`	Installationen saknar konfiguration för API:et.

Felkroppens fält och råd om omförsök står på Fel och statuskoder.

Kodexempel

curl -X GET "https://din-installation.se/api/v1/meta" \
  -H "Authorization: Bearer dk_live_DIN_NYCKEL"