Hent dit forbrug via API'et

Vil du vise dit API-forbrug i dit eget dashboard i stedet for at logge ind hos os, kan du hente tallene direkte.

Tre endpoints

• GET /v1/usage — dagens og månedens forbrug op mod din kvote.
• GET /v1/usage/history — de seneste 90 dage, én række pr. dag.
• GET /v1/usage/stats — den detaljerede, som du kan gruppere.

Base-URL er https://api.danskadresseapi.dk.

Kom i gang

curl "https://api.danskadresseapi.dk/v1/usage/stats" \
  -H "Authorization: Bearer sk_live_..."

Du får en række pr. dag med kald, fakturerbare, fejl og gns_latency_ms.

Gruppér tallene

Parameteren gruppering tager dag (standard), time, endpoint eller noegle:

# Hvilke endpoints fylder mest?
curl "https://api.danskadresseapi.dk/v1/usage/stats?gruppering=endpoint" \
  -H "Authorization: Bearer sk_live_..."

Med gruppering=noegle får du navnet på nøglen med i feltet navn — nyttigt hvis du har én nøgle pr. miljø og vil se hvad test bruger i forhold til produktion.

Du kan afgrænse perioden med fra og til (ÅÅÅÅ-MM-DD). Standard er de seneste 30 dage.

Krav til nøglen

Det kræver en live-nøgle med scope'et usage. Public-nøgler kan ikke læse kontooplysninger.

Har din nøgle begrænsede scopes, skal du sætte flueben ved usage under nøglens indstillinger. Ellers får du en 403.

Godt at vide

• Tallene er aggregeret pr. minut og gemmes omkring en måned. Skal du bruge længere historik, så hent og gem den løbende — vi kan ikke rekonstruere den bagudrettet.
• fejl dækker både 4xx og 5xx. fakturerbare er kun de kald der tæller mod din kvote.
• gns_latency_ms er vores svartid. Netværkstiden ud til dig er ikke med, så tallet er lavere end det dine egne målinger viser.
• Svaret indeholder endpoint-navne og tællere, aldrig hvad dine brugere har søgt på. Du kan derfor vise det i din egen brugerflade, uden at det bliver persondata.