Slå jordstykker op i batch
Jordstykkerne for mange ejendomme i ét kald — 50 på Pro, flere på Scale og Enterprise — med et resultat eller en fejl for hvert BFE-nummer.
https://api.grundfast.dk/v1/matrikel/ejendom:batchSend en liste af BFE-numre, og få hver ejendoms jordstykker tilbage i samme form som fra Hent ejendommens jordstykker. Dubletter fjernes, før opslagene går i gang, og requested er antallet af unikke numre.
Svaret er 200, også når nogle af numrene fejler: de fejlede står i errors med deres egen status, og resten står i results. Kun en ugyldig krop giver 400. Punkt-i-tid-opslag understøttes ikke i batch.
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
Kvoten tæller ét kald pr. unikt BFE-nummer; der faktureres kun for de numre, der blev slået op.
Eksempel
curl -X POST "https://api.grundfast.dk/v1/matrikel/ejendom:batch" \
-H "Authorization: Bearer $GRUNDFAST_API_KEY" \
-H "Content-Type: application/json" \
-d '{"bfe":[5651067,2425322]}'{
"results": [
{
"bfe": 5651067,
"ejendom": {
"bfe_nummer": 5651067,
"type": "samlet_fast_ejendom",
"jordstykker": [
{
"id": "1928359",
"matrikelnummer": "138o",
"ejerlav": {
"kode": 2006552,
"navn": "Silkeborg Markjorder"
},
"areal_m2": 460,
"kommunekode": "0740",
"geometri": {
"type": "Polygon",
"coordinates": [
[
[
9.5326405,
56.1579596
],
[
9.532631,
56.1579199
],
[
9.5326084,
56.1578249
],
[
9.5330829,
56.1577643
],
[
9.5331362,
56.1578905
],
[
9.5326405,
56.1579596
]
]
],
"epsg25832_ring": [
[
533083.822,
6223788.017
],
[
533083.267,
6223783.588
],
[
533081.942,
6223773.004
],
[
533111.469,
6223766.491
],
[
533114.672,
6223780.561
],
[
533083.822,
6223788.017
]
]
}
}
],
"dagi": {
"kommune": {
"kode": "0740",
"navn": "Silkeborg"
},
"region": {
"kode": "1082",
"navn": "Region Midtjylland"
}
},
"meta": {
"kilde": "Datafordeler Matriklen via Grundfast",
"grundfast_version": "0.1.0"
}
},
"stale": false
}
],
"errors": [],
"requested": 2,
"succeeded": 2,
"failed": 0
}Forkortet: lange lister og geometrier er skåret ned — de viste værdier er uændrede.
Request-body
JSON med Content-Type: application/json.
bfeinteger[]bodypåkrævet- BFE-numre. 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. Grænsen gælder listen, efter at dubletter er fjernet.
Felter i svaret
results[]object[]{ bfe, ejendom, stale }for hvert nummer, der kunne slås op.ejendomhar samme form som et enkeltopslag.results[].stalebooleantruenår jordstykkerne blev serveret fra cache, fordi Matriklen var nede.errors[]object[]{ bfe, error, status }for hvert nummer, der fejlede — fx404for et ukendt BFE.failedinteger- Antal fejlede numre.
requested=succeeded+failed.
Statuskoder
| Status | Betydning |
|---|---|
| 200 | Svaret er leveret. |
| 400 | Kroppen er ikke { bfe: number[] } med positive heltal, 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; hele batchens antal enheder tæller mod kvoten. 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
- GETHent ejendommens jordstykker
/v1/matrikel /ejendom /:bfe - POSTSlå op i batch
/v1/bbr /ejendom:batch - POSTOpret en eksport
/v1/export
Læs mere om Matriklen, og hvad data kan bruges til, på produktsiden.