Spring til indhold

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/profil er ét kald pr. punkt i profilen; /v1/dhm/terraen er é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-Remaining stå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

Med en gratis nøgle får du begrebet som felt i svaret — oversat, med WGS84-geometri og på tværs af registrene med samme BFE-nummer.

Gratis op til 5.000 kald/md · intet kreditkort · data fra Klimadatastyrelsen/Datafordeler, CC BY 4.0

Relaterede begreber