Download eksporten
Den færdige eksportfil som CSV, NDJSON eller GeoJSON; svarer 409, så længe filen ikke er klar.
https://api.grundfast.dk/v1/export/{id}/downloadSvaret er selve filen med en Content-Disposition, der navngiver den efter jobbet, fx exp_….csv. Content-Type følger formatet: text/csv, application/x-ndjson eller application/geo+json, alle i UTF-8.
CSV-celler, der starter med =, +, - eller @, får et foranstillet ', så et regneark ikke læser dem som formler.
completed og alligevel give 409, fordi filen slettes efter en opbevaringsperiode. Tjek resultAvailable, før du downloader — og gem aldrig et 409-svar som om det var filen.Godkendelse · API-nøgle eller session
Virker med en Authorization: Bearer-nøgle eller med din login-session i dashboardet.
Kræver Scale-planen
På en lavere plan svarer endpointet 402. Se planerne.
Afregning
Ikke målt — eksporten er betalt, da den blev oprettet.
Eksempel
curl "https://api.grundfast.dk/v1/export/exp_k3v9q2m7x1r8t4w6y0z5b2nc/download" \
-H "Authorization: Bearer $GRUNDFAST_API_KEY"bfe_nummer,kommunekode,antal_bygninger,matrikelnummer,ejerlav_navn
5651067,0740,3,138o,Silkeborg Markjorder
2425322,0306,4,1gæ,"Ellinge Hgd., Højby"
Parametre
idstringstipåkrævet- Jobbets id fra
job.id.Eksempel:exp_k3v9q2m7x1r8t4w6y0z5b2nc
Statuskoder
| Status | Betydning |
|---|---|
| 200 | Svaret er leveret. |
| 401 | Hverken en gyldig nøgle eller en session. |
| 402 | Planen er under Scale. |
| 403 | Nøglen er en admin-nøgle, eller kontoen er suspenderet. |
| 404 | Der findes intet job med det id på din konto. |
| 409 | Filen er ikke klar: jobbet er queued, processing eller failed, eller filen er slettet efter opbevaringsperioden. Status står i fejlbeskeden. |
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øgle