REST-API

Konto och saldo

Ditt konto, saldot, månadens förbrukning och nyckelns scopes och miljö. Gratis och mäts inte.

http

GET /api/v1/account

Headers: Authorization: Bearer … (krävs) och Idempotency-Key (valfri).

Anropet är gratis, mäts inte och räknas inte mot någon kvot utom takten per minut. Det fungerar också när live-data är stängd, så det passar som hälsokontroll av en nyckel.

Exempel#

curl -s "http://localhost:3020/api/v1/account" \
  -H "Authorization: Bearer $GETBOLAG_KEY"

Om svaret#

Kontot: namn, organisationsnummer och status (till exempel active eller pending_review).
Saldot i kronor och månadens förbrukning mot månadstaket.
Nyckeln eller OAuth-anslutningen som gjorde anropet: miljö (live eller test) och scopes.

Exakta fältnamn står i OpenAPI-specifikationen.

Kod	HTTP	Vad du gör
`unauthorized`	401	Skicka `Authorization: Bearer gb_test_…` eller `gb_live_…`. Kontrollera att hela nyckeln kom med. En OAuth-token gäller en timme; förnya den med refresh-token.
`email_not_verified`	403	Klicka på länken i bekräftelsemejlet, eller skicka ett nytt från Konto.
`user_disabled`	403	Be kontots ägare att aktivera användaren, eller använd en egen nyckel.
`rate_limited`	429	Vänta så många sekunder som `Retry-After` anger och försök igen. Se takt och tak.
`internal_error`	500	Försök igen med samma `Idempotency-Key`. Ange `request_id` om du kontaktar support.