Slå mange adresser op
Mange DAR-adresser i ét kald — 50 på Pro, flere på Scale og Enterprise — med resultat eller fejl for hver UUID.
https://api.grundfast.dk/v1/adresse:batchHver UUID slås op præcis som med /v1/adresse/:uuid. Dubletter fjernes, før noget slås op — også når de kun adskiller sig i store og små bogstaver.
En UUID, der ikke kan slås op, vælter ikke kaldet: den lander i errors med sin egen status, og svaret er stadig 200. Kun en ugyldig body giver 400.
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.
Kræver Pro-planen
På en lavere plan svarer endpointet 402. Se planerne.
Afregning
Én enhed pr. unik UUID trækkes fra kvoten; kun de opslag, der lykkes, faktureres.
Eksempel
curl -X POST "https://api.grundfast.dk/v1/adresse:batch" \
-H "Authorization: Bearer $GRUNDFAST_API_KEY" \
-H "Content-Type: application/json" \
-d '{"uuid":["0a3f507a-ec01-32b8-e044-0003ba298018","74806df4-97a9-4c0c-a6cb-df07b5429e07"]}'{
"results": [
{
"uuid": "0a3f507a-ec01-32b8-e044-0003ba298018",
"adresse": {
"id": "0a3f507a-ec01-32b8-e044-0003ba298018",
"betegnelse": "Rådhuspladsen 1, 1550 København V",
"vejnavn": "Rådhuspladsen",
"husnr": "1",
"etage": null,
"doer": null,
"postnr": "1550",
"postnrnavn": "København V",
"kommunekode": null,
"koordinat": { "lon": 12.5695777, "lat": 55.6756275 }
},
"stale": false
}
],
"errors": [
{
"uuid": "74806df4-97a9-4c0c-a6cb-df07b5429e07",
"error": "upstream Datafordeler error",
"status": 502
}
],
"requested": 2,
"succeeded": 1,
"failed": 1
}Request-body
JSON med Content-Type: application/json.
uuidstring[]bodypåkrævet- DAR-id’er (UUID), enhedsadresser eller adgangsadresser. Antallet pr. kald følger planen: 50 på Pro, 100 på Scale og 150 på Enterprise. En længere liste afvises med
402, der nævner den plan, der tager den — eller send listen som et job.
Felter i svaret
results[]object[]{ uuid, adresse, stale }for hver UUID, der blev slået op.adressehar samme form som på enkeltopslaget.results[].stalebooleantruenår adressen kom fra cachen, fordi DAR ikke svarede.errors[]object[]{ uuid, error, status }for hver UUID, der fejlede — fx404for en adresse, der ikke er gældende.requestedinteger- Antal unikke UUID’er efter dubletfjernelse.
succeeded+failedgiver det samme tal.
Statuskoder
| Status | Betydning |
|---|---|
| 200 | Svaret er leveret. |
| 400 | Body er ikke { uuid: string[] } med gyldige UUID’er, eller listen er længere, end nogen plan tager pr. kald. |
| 401 | Nøglen mangler eller er ugyldig. |
| 402 | Planen er under Pro, eller listen er længere end din plans loft pr. kald. Svaret nævner den plan, der tager den. |
| 429 | Burst-grænsen eller månedskvoten er nået — kvoten tjekkes mod hele batchens antal enheder. |
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å en adresse op
/v1/adresse /:uuid - GETSøg efter en adresse
/v1/adresse /search - POSTSlå op i batch
/v1/bbr /ejendom:batch - POSTVask mange adresser
/v1/datavask /adgangsadresser:batch
Læs mere om Adresser (DAR), og hvad data kan bruges til, på produktsiden.