Hent webhook-hændelser
Alle hændelser, Grundfast har dannet til dine webhook-endpoints, ældste først — med data og hvordan leveringen gik.
https://api.grundfast.dk/v1/me/webhooks/eventsDen sikre vej tilbage efter et nedbrud hos din modtager: læs fra dit sidste kendte tidspunkt med status=failed, og behandl det, du ikke har set — eller send det igen med Send fejlede igen.
data er præcis det, der blev (eller bliver) sendt. delivery.status er den seneste tilstand: en hændelse, der fejlede og siden blev sendt igen med held, står som success med redeliveries: 1. Hændelser gemmes i retentionDays dage; et since før coveredFrom læser fra coveredFrom.
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 -G "https://api.grundfast.dk/v1/me/webhooks/events" \
--data-urlencode "status=failed" \
--data-urlencode "since=2026-10-10" \
-H "Authorization: Bearer $GRUNDFAST_API_KEY"{
"events": [
{
"id": "whd_74rxu7q98u3kl3u6ok67q5y3",
"event": "key.revoked",
"created": "2026-10-13T12:47:49.607Z",
"data": { "key_id": 2 },
"webhookId": "wh_g6omjl6xaqe6syjuz2wd4sws",
"delivery": {
"id": "whd_74rxu7q98u3kl3u6ok67q5y3",
"status": "failed",
"attempts": 5,
"responseStatus": 500,
"error": "endpoint returned 500",
"lastAttemptAt": "2026-10-13T12:47:52.631Z",
"deliveredAt": null,
"redeliveries": 0
}
}
],
"nextCursor": "ZToz",
"hasMore": false,
"retentionDays": 30,
"coveredFrom": "2026-09-13T12:48:11.695Z"
}Parametre
statusstringqueryvalgfri- Kun hændelser med denne seneste leveringstilstand.Værdier:pendingsuccessfailedEksempel:
failed eventstringqueryvalgfri- Kun én hændelsestype, fx
adresse.aendret. webhookstringqueryvalgfri- Kun hændelser til ét endpoint (
wh_…). sincestringqueryvalgfri- Kun hændelser fra denne dato eller dette tidspunkt (ISO 8601).Eksempel:
2026-10-10 cursorstringqueryvalgfrinextCursorfra forrige side.limitintegerqueryvalgfri- Hændelser pr. side, 1-100.Standard:25
Felter i svaret
events[].idstring- Hændelsens id — det samme som
X-Grundfast-Deliverypå leveringen. events[].deliveryobject- Seneste forsøg:
status,attempts,responseStatus,error,lastAttemptAt,deliveredAtogredeliveries. nextCursorstring- Send som
cursori næste kald; du springer aldrig over og ser aldrig en hændelse to gange. hasMoreboolean- Flere hændelser venter efter denne side.
Statuskoder
| Status | Betydning |
|---|---|
| 200 | Svaret er leveret. |
| 400 | En ugyldig status, since, limit eller en cursor, API’et ikke har udstedt. |
| 404 | webhook er ikke et af dine endpoints. |
| 401 | Hverken en gyldig nøgle eller en session. |
| 403 | Nøglen har ikke scopet webhooks (key_scope_missing), eller kontoen er suspenderet. |
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