Notifikationer og webhooks for jobs

4 min læsning

Du behøver ikke holde øje med et langt job. Når det er færdigt, fejler eller stopper ved kvoten, får du besked — i dashboardet, i klokken og på mail. Din egen kode kan få det samme som en webhook.

Hvem får besked?

Kun den, der startede jobbet — og kun mens vedkommende stadig er medlem af teamet. For et job, der er oprettet via API'et, er det den, der ejer nøglen. Beskeder i dashboardet vises kun, når du står i det team, jobbet tilhører.

Annullerer du selv et job, får du ingen besked. Annullerer en kollega dit job, får du det at vide.

Hvornår og hvordan

Hændelse	Toast i dashboardet	Klokken	Mail
Job færdigt	ja	ja	kun hvis jobbet kørte over 2 minutter, eller du ikke var online
Job færdigt med fejlrækker	ja	ja	samme regel som «Job færdigt»
Job fejlet	ja	ja	ja
Job stoppet ved kvoten	ja	ja	ja
Job annulleret af en anden	ja	ja	nej
Job sat på pause af en anden	nej	ja	nej
Resultat slettes snart (24 timer før, hvis ingen har hentet det)	nej	ja	ja
Job startet efter kø (har ventet over 1 minut)	ja	nej	nej

Toasten har knapper til det, du typisk skal bagefter — fx Hent resultat, Se fejlrækkerne eller Åbn jobbet.

Slå beskeder til og fra

Alle job-beskeder er slået til fra start. Du kan slå hver hændelse fra for sig — pr. kanal:

Gå til Indstillinger → Notifikationer i dashboardet.
Find gruppen Jobs.
Slå I appen (toast og klokke) og/eller E-mail fra for de hændelser, du ikke vil have. Et «–» betyder, at hændelsen ikke sendes på den kanal.
Klik Gem ændringer.

Indstillingerne er dine egne — de påvirker ikke dine kolleger. Jobs sender ikke beskeder til Telegram.

Webhooks

Vil du have din egen kode til at reagere, når et job er færdigt, så brug en webhook i stedet for at spørge efter status igen og igen.

Sådan sætter du det op:

Gå til Webhooks i dashboardet, og tilføj et endpoint (https).
Vælg hændelserne i gruppen Jobs.
Verificér signaturen i headeren X-Addr-Signature med din signeringsnøgle.

Webhooks følger teamets abonnement — ikke den enkeltes notifikationsindstillinger. De sendes for alle teamets jobs, uanset hvem der startede dem. På jobbets detaljeside viser fanen Webhooks, hvad der er sendt for jobbet, og om det blev leveret.

Hændelse	Sendes når
`job.completed`	Jobbet er færdigt — også når nogle rækker ikke kunne matches (se `fejl` og `ok`)
`job.failed`	Jobbet stoppede på grund af en fejl
`job.quota_stopped`	Teamets kvote blev brugt op, mens jobbet kørte
`job.cancelled`	Jobbet blev annulleret — af hvem som helst. `annulleret_af_starter` fortæller, om det var den, der startede det
`job.result_expiring`	Resultatet slettes inden for 24 timer, og ingen har hentet det
`job.paused`	Jobbet blev sat på pause. `af_starter` fortæller, om det var den, der startede det
`job.resumed`	Jobbet blev genoptaget efter en pause

job.completed, job.failed, job.quota_stopped, job.cancelled og job.result_expiring sendes højst én gang pr. job; job.paused og job.resumed sendes hver gang, det sker. Hændelsens type står i headeren X-Addr-Event-Type, og et unikt id i X-Addr-Event-Id — gem id'et, så du kan afvise dubletter ved genforsøg.

Jobbets data i webhooken har de samme felter som jobbet i GET /v1/jobs/{id} (dog uden raekke_fejl), plus ok (rækker uden fejl) og dashboard_url:

JSON

{
  "id": "7c0e6f0a-3b1d-4f5e-9a51-2d4c8b1e9f20",
  "type": "datavask",
  "variant": "adresser",
  "kilde": "dashboard",
  "navn": "kunder-oktober.csv",
  "status": "faerdig",
  "total": 48522,
  "behandlet": 48522,
  "fejl": 312,
  "ok": 48210,
  "procent": 100,
  "raekker_pr_sek": 1840,
  "eta_sek": null,
  "afregnede_opslag": 48210,
  "fejlbesked": null,
  "oprettet": "2026-10-04T14:11:31.000Z",
  "startet": "2026-10-04T14:11:32.000Z",
  "faerdig": "2026-10-04T14:12:08.000Z",
  "udloeber": "2026-10-11T14:12:08.000Z",
  "resultat": {
    "ndjson": "https://api.danskadresseapi.dk/v1/jobs/7c0e6f0a-3b1d-4f5e-9a51-2d4c8b1e9f20/resultat?format=ndjson",
    "csv": "https://api.danskadresseapi.dk/v1/jobs/7c0e6f0a-3b1d-4f5e-9a51-2d4c8b1e9f20/resultat?format=csv"
  },
  "job_fejl": null,
  "dashboard_url": "https://danskadresseapi.dk/dashboard/jobs?job=7c0e6f0a-3b1d-4f5e-9a51-2d4c8b1e9f20"
}

Ved job.failed og job.quota_stopped står årsagen i job_fejl (kode, forklaring og evt. reference) — se Når et job fejler — fejlkoder. Resultatet hentes med links'ene i resultat og din API-nøgle.

Mere om signatur, genforsøg og webhookens ramme: Webhooks-guiden.

Var dette nyttigt?