Hent alle postnumre
Alle danske postnumre med distriktsnavn i ét svar.
https://api.grundfast.dk/v1/postnumreErstatter DAWA’s /postnumre. Listen udledes af adresserne i DAR og returneres samlet, sorteret efter nummer — der er ingen sideinddeling. Svaret er { antal, total, postnumre, meta } i stedet for et bart array, og hvert postnummer er { nr, navn, stormodtager }.
Stormodtager-postnumre er udfaset og er som standard ikke med, ligesom i DAWA. Med stormodtagere=true kommer de historiske koder med, markeret stormodtager: true.
Godkendelse · API-nøgle
Send din nøgle som Authorization: Bearer gf_live_… — eller gf_test_… for gratis sandbox-kald. Se Godkendelse og nøgler.
Afregning
Ét kald.
Eksempel
curl "https://api.grundfast.dk/v1/postnumre" \
-H "Authorization: Bearer $GRUNDFAST_API_KEY"{
"antal": 1089,
"total": 1089,
"postnumre": [
{ "nr": "1050", "navn": "København K", "stormodtager": false },
{ "nr": "1051", "navn": "København K", "stormodtager": false },
{ "nr": "1052", "navn": "København K", "stormodtager": false }
],
"meta": {
"kilde": "Datafordeler DAR (postnumre) via Grundfast",
"grundfast_version": "0.1.0"
}
}Forkortet: lange lister og geometrier er skåret ned — de viste værdier er uændrede.
Parametre
stormodtagerebooleanqueryvalgfri- Tag de historiske stormodtager-postnumre med.
true,1eller en tom værdi slår det til.Standard:false
Felter i svaret
postnumre[].nrstring- Firecifret postnummer som streng, fx
"8000". postnumre[].navnstring | null- Distriktsnavnet, fx "Aarhus C".
postnumre[].stormodtagerbooleantruekun for de historiske stormodtager-koder, du har bedt om.
Statuskoder
| Status | Betydning |
|---|---|
| 200 | Svaret er leveret. |
| 401 | Nøglen mangler eller er ugyldig. |
| 429 | Burst-grænsen eller månedskvoten er nået. Se Retry-After. |
Alle fejl har samme form. Byg logikken på type (fejlklassen) og vis message (dansk tekst med årsagen) til brugeren; hint kommer med, når vi kan se, hvad der skal rettes, og request_id er det, support skal bruge. Se Fejl og statuskoder for hver type, og hvad der kan prøves igen.
{
"error": "property not found",
"type": "not_found",
"code": "not_found",
"message": "Ressourcen findes ikke.",
"request_id": "6cbfa45a-a9ea-4140-9d42-ea752a70ff1f",
"doc_url": "https://grundfast.dk/docs/fejl#not_found"
}Prøv det
Live-kald fra siden
Kræver din nøgleBruges ofte sammen med
- GETSlå et postnummer op
/v1/postnumre /:nr - GETAutocomplete på postnumre
/v1/postnumre /autocomplete - GETHent vejnavne
/v1/vejnavne
Læs mere om Adresser: lister, autocomplete og reverse, og hvad data kan bruges til, på produktsiden.