Hent resultatfilen
Rækkerne med et svar som CSV eller NDJSON — også mens jobbet kører.
https://api.grundfast.dk/v1/jobs/{id}/resultsCSV starter med dine egne kolonner, præcis som du sendte dem, og har vores kolonner til højre med præfikset gf_, så de aldrig støder sammen med dine. Filen starter med et UTF-8-BOM, så Excel læser æ, ø og å rigtigt, og separator=semicolon giver en fil, en dansk Excel åbner direkte.
NDJSON har én linje pr. række: { raekke, input, resultat }, hvor raekke er rækkens nummer i din liste (fra 1). Svaret er et kompakt udtræk pr. række — vil du have hele objektet, så slå op i enkeltkaldet.
Tekstceller, der starter med =, +, - eller @, får et foranstillet ' i CSV, så et regneark ikke læser dem som formler.
Godkendelse · API-nøgle eller session
Virker med en Authorization: Bearer-nøgle eller med din login-session i dashboardet.
Afregning
Ikke målt.
Eksempel
curl "https://api.grundfast.dk/v1/jobs/job_4n8q2v7k1m9x3c5z0w6r2t8b/results" \
-H "Authorization: Bearer $GRUNDFAST_API_KEY"kunde;adresse;gf_kategori;gf_score;gf_antal_kandidater;gf_adgangsadresse_id;gf_betegnelse;gf_vejnavn;gf_husnr;gf_postnr;gf_postnrnavn;gf_kommunekode;gf_bfe_nummer;gf_lon;gf_lat
1001;Rådhuspladsen 1, 1550 København V;A;1;1;0a3f507a-ec01-32b8-e044-0003ba298018;Rådhuspladsen 1, 1550 København V;Rådhuspladsen;1;1550;København V;0101;6033528;12.5695777;55.6756275
Parametre
idstringstipåkrævet- Jobbets id fra
job.id.Eksempel:job_4n8q2v7k1m9x3c5z0w6r2t8b formatstringqueryvalgfricsvellerndjson.Standard:csvVærdier:csvndjsonseparatorstringqueryvalgfri- Kun CSV:
commaellersemicolon.Standard:commaVærdier:commasemicolon
Statuskoder
| Status | Betydning |
|---|---|
| 200 | Svaret er leveret. |
| 400 | format eller separator har en ukendt værdi. |
| 401 | Hverken en gyldig nøgle eller en session. |
| 403 | Nøglen er en admin-nøgle, eller kontoen er suspenderet. |
| 404 | Der findes intet job med det id på din konto. |
| 409 | Jobbet er en kladde, der ikke er startet. |
| 410 | Rækkerne er slettet efter opbevaringsperioden. Jobbet står stadig på listen. |
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