Følg et job og hent resultatet

Alle teamets jobs står under Jobs i dashboardet (menuen API → Jobs, eller danskadresseapi.dk/dashboard/jobs). Listen opdateres live: nye jobs glider ind, og fremdrift, rækker pr. sekund og forventet tid tæller op, mens jobbet kører.

Start et job

1. Klik Nyt job.
2. Vælg type (og variant), og træk filen ind — eller klik vælg fil.
3. Dashboardet læser filen med den samme parser som jobbet og viser de første rækker, hvor mange opslag jobbet bruger, og om kvoten rækker. Er der en fejl i filen, ser du linjenummeret med det samme.
4. Vælg den nøgle, jobbet afregnes på, og start jobbet.

Kun teammedlemmer, der må oprette API-nøgler, kan starte jobs.

Status — hvad betyder den?

Status	Betyder	Kan resultatet hentes?
koe	Venter på en ledig plads i køen	Nej
koerer	Jobbet behandles lige nu	Ikke endnu
pauset	Sat på pause — den del, der var i gang, blev gjort færdig og gemt. Genoptages fra samme sted	Ja, delresultatet
faerdig	Alle rækker er behandlet	Ja
fejlet	Jobbet stoppede på grund af en fejl — se fejlkoden	Ja, delresultatet
kvote_stop	Teamets kvote (eller overforbrugsloft) blev nået undervejs	Ja, delresultatet
annulleret	Nogen annullerede jobbet	Ja, delresultatet
udloebet	Resultatet er slettet (efter 7 eller 30 dage)	Nej

Et job på pause bruger ingen opslag og optager ikke en af teamets pladser til aktive job. Genoptages det ikke, inden resultatet udløber, slettes det med fejlkoden pause_udloebet.

Venter på kapacitet — et job med status koerer kan midlertidigt vise «Venter på kapacitet». Det betyder, at API'et er travlt, og at jobbet venter med sin næste del, så almindelige kald går forud. Enterprise-jobs venter først ved højere belastning end Pro-jobs. Et job venter højst ca. 2 minutter pr. del, intet går tabt, og jobbet fortsætter selv. I API'et står det som venter_paa_kapacitet: true.

Et faerdig job kan godt have rækker, der ikke gav et svar — fx en adresse, der ikke kunne genkendes. De står som «fejl» eller «advarsler» på jobbet; se Rækker der ikke kunne behandles.

Jobbets detaljeside

Klik på et job for at åbne detaljesiden. Øverst ser du status, fremdrift, varighed og antal rækker, og under fanerne:

• Oversigt — behandlingstid (rækker pr. sekund over tid), nøgletal, input-filen og jobbets konfiguration (type, variant, skilletegn, tegnsæt, om første række er overskrift, nøglen og hvornår resultatet slettes).
• Data — resultatet side for side med søgning, statistik pr. status og en forklaring af kolonnerne.
• Fejl og advarsler — rækkerne, der ikke gav et (sikkert) svar, med årsag.
• Rå respons — de første rækker præcis som gemt (NDJSON).
• Webhooks — de webhooks, der er sendt for jobbet, og om de blev leveret.
• Historik — oprettet, ventetid i kø, startet, dele gemt, afsluttet og hvornår resultatet blev hentet første gang.

Er jobbet stoppet af en fejl, står fejlkoden, en forklaring og de mulige handlinger øverst — se Når et job fejler — fejlkoder.

Handlinger

• Download resultat (CSV, NDJSON — eller JSONL for en eksport).
• Sæt på pause / Genoptag — et job i kø eller i gang kan sættes på pause: den del, der er i gang, gøres færdig og gemmes, og derefter bruges ingen nye opslag. Genoptag lægger jobbet i kø igen, og det fortsætter præcis efter sidste gemte række (kvoten tjekkes først — rækker den ikke til resten, får du en advarsel). Pausen forlænger ikke, hvor længe resultatet og inputtet gemmes. Via API'et: POST /v1/jobs/{id}/pause og POST /v1/jobs/{id}/genoptag.
• Fortsæt — et job, der er fejlet, stoppet ved kvoten (kvote_stop) eller annulleret, fortsætter på samme job, hvor det slap. De behandlede rækker bevares, og kun resten tæller i kvoten (kvoten tjekkes først). Kræver, at inputtet ikke er slettet endnu. Findes i dashboardet.
• Kør igen — et nyt job med samme input og konfiguration, fx efter du har rettet noget. Hver række med svar tæller igen som ét opslag. Er inputtet slettet, afvises det med input_udloebet. Findes i dashboardet.
• Annullér — et job i kø, i gang eller på pause stopper. Det, der nåede at blive behandlet, kan hentes.
• Download input, Kopiér job-id og Slet job (sletter job, resultat og input — kan ikke fortrydes; et job i gang skal annulleres først).

Resultatet

Resultatet kan hentes i to formater:

NDJSON — én JSON-linje pr. række, præcis det samme objekt som de synkrone batch-endpoints svarer med, plus idx (rækkens plads i din fil, 0 = første datarække). Alle match er med.

CSV — én linje pr. række med faste kolonner. UTF-8 med BOM (så Excel viser æ, ø og å rigtigt), komma som skilletegn, og felter med komma, citationstegn eller linjeskift står i "…". For reverse og datavask er det bedste match, der står i CSV'en.

Type	Kolonner i CSV
reverse	idx, lat, lon, antal_match, adgangsadresse_id, adresse, vejnavn, husnr, postnr, postnrnavn, kommunekode, adresse_lat, adresse_lon
datavask	idx, input, kategori, score, historisk, variant, adresse, id, adgangsadresse_id, vejnavn, husnr, etage, doer, postnr, postnrnavn, kommunekode, lat, lon, fejl
bbr (bygninger)	idx, id, fundet og bygningens BBR-felter (status, anvendelse, opførelsesår, arealer, materialer, varme, vand, afløb m.fl.)
bbr (enheder)	idx, id, fundet og enhedens BBR-felter (status, anvendelse, boligtype, arealer, værelser, toilet-, bad- og køkkenforhold m.fl.)
dagi	idx, lat, lon, postnr, kilde, kode og navn for sogn, kommune, region, politikreds, retskreds, opstillingskreds, storkreds, landsdel og valglandsdel, afstemningsområde, fejl
eksport	Samme kolonner som ejendomssøgningen i Find ejendomme

For datavask betyder kategori: A = sikkert match, B = usikkert match (tjek det bedste bud), C = intet match. For DAGI-opslag på postnummer står kommuner, sogne m.fl. som en JSON-liste i cellen, fordi et postnummer kan ligge i flere.

Den komplette kolonneliste for din type står også på detaljesidens fane Data → Kolonner og under Se filformat.

Fejlrækkerne

Rækker, der ikke gav et svar, kan hentes for sig — så du kan rette dem og køre dem igen:

• I dashboardet: fanen Fejl og advarsler viser rækkerne med årsag, og Hent fejlrækker (CSV) henter dem.
• Via API'et: GET /v1/jobs/{id}/fejl giver en CSV (eller NDJSON med ?format=ndjson) med kolonnerne:

Kolonne	Indhold
raekke	Rækkens nummer blandt datarækkerne (1 = første række under overskriften)
inputkolonnerne	Det, jobbet læste fra din fil: lat, lon, radius, limit (reverse) · betegnelse (datavask) · id (BBR) · lat, lon, postnr (DAGI)
aarsag	Årsagens kode, fx ikke_tolket — se Rækker der ikke kunne behandles
alvor	fejl (intet svar) eller advarsel (svaret er usikkert eller tomt)
forklaring	Hvad årsagen betyder, og hvad du kan gøre
bedste_bud	Det bedste svar, rækken trods alt gav (datavask kategori B og C)

Tilføj ?aarsag=ikke_tolket for kun én årsag, og ?sprog=en for forklaringer på engelsk.

Når resultatet slettes

Resultatet og inputtet slettes 7 dage (Pro) eller 30 dage (Enterprise) efter, at jobbet sluttede. Datoen står under «Job konfiguration». Har ingen hentet resultatet, får du en påmindelse 24 timer før — se Notifikationer og webhooks for jobs.