BegrebKald, kvoter og nøgler · Grundfast
Kald
Et kald er den enhed, Grundfast måler forbrug i: ét opslag mod API’et, der lykkes, er ét kald. Planernes kvoter og prisen for overforbrug er angivet i kald.
Også kaldt: API-kald, Opslag, Forespørgsel
Hvad der tæller
Et opslag, der svarer 2xx, tæller som ét kald — uanset register, og uanset om svaret kom fra cachen eller direkte fra kilden. Et opslag på /v1/bbr/ejendom/:bfe er ét kald, også selvom svaret samler grund, bygninger, enheder og adresser, som det ville kræve mange forespørgsler at hente hos kilden.
- Batch tæller pr. id. Et
:batch-kald med 40 BFE-numre er 40 kald. Dubletter tælles én gang, og id’er, der ikke kunne slås op, afregnes ikke. - Eksport tæller pr. id. Id’er, der ikke kunne hentes, krediteres tilbage.
- Højdeprofiler tæller pr. punkt.
/v1/dhm/profiler ét kald pr. punkt i profilen;/v1/dhm/terraener ét kald for hele nettet. - MCP tæller som REST. Et værktøjskald fra en AI-agent, der lykkes, er ét kald. Opstart, værktøjsliste og fejlede værktøjskald er gratis.
Hvad der ikke koster noget
Fejl hos os eller hos kilden — 5xx og timeout — lægges tilbage i kvoten og afregnes aldrig. Klientfejl (4xx, fx et BFE-nummer, der ikke findes) afregnes heller ikke, men tæller med i kvotetælleren. De nøglefri demo-endpoints, som dokumentationen bruger, tæller ikke mod nogen plan, og kald med en testnøgle faktureres aldrig.
Det skal du vide som udvikler
- Ét kald er ikke ét register. Ét samlet ejendomsopslag er billigere end at slå bygninger, jordstykker og adresser op hver for sig — vælg det endpoint, der svarer på hele spørgsmålet.
- Cache selv det, der ikke ændrer sig. Kodelister, postnumre og kommuner ændrer sig sjældent; hent dem én gang og gem dem.
- Følg forbruget i headerne.
X-Quota-Remainingstår på hvert svar, så du kan se, hvor mange kald der er tilbage af månedskvoten.
Skal du regne et budget, så tæl de opslag, din integration laver pr. bruger eller pr. sag, og gang med det forventede antal om måneden. Beregneren på /priser bruger samme regnestykke som fakturaen.
I API’et
Slå det op på en rigtig ejendom
Gratis op til 5.000 kald/md · intet kreditkort · data fra Klimadatastyrelsen/Datafordeler, CC BY 4.0
Relaterede begreber
- MånedskvoteMånedskvoten er det antal kald, en plan indeholder pr. kalendermåned. Den nulstilles den 1. i måneden kl. 00:00 UTC, og forbrug over den afregnes som overforbrug på de betalte planer.
- TestnøgleEn testnøgle er en API-nøgle, der begynder med gf_test_. Den rammer de samme rigtige registre som en live-nøgle (gf_live_), men faktureres aldrig og tæller ikke mod planens kvote.
- BFE-nummerBFE-nummeret er det nummer, en Bestemt Fast Ejendom har i de danske ejendomsregistre. Det er den fælles nøgle, der binder grunden i Matriklen, bygningerne i BBR, vurderingen og ejerskabet sammen.