Rejestry doręczeń

Rejestry doręczeń pozwalają zobaczyć, co stało się z każdym doręczeniem webhooka dla endpointu: czy się powiodło, jest ponawiane, czy zawiodło, oraz jaki był ostatni zaobserwowany status HTTP. To oczyszczona diagnostyka: treści odpowiedzi odbiorcy, nagłówki, podpisy, sekrety i surowe payloady nigdy nie są przechwytywane. Ten widok jest tylko do odczytu i nie odtwarza, nie resetuje ani nie usuwa doręczeń. Model podpisu i ponowień opisują Webhooki — przegląd.

Wylistuj doręczenia

Listuje najnowsze oczyszczone rejestry doręczeń dla jednego nieusuniętego endpointu webhooka należącego do uwierzytelnionego konta. Endpoint jest wyłącznie diagnostyczny, nie ma możliwości odtwarzania, resetu, usuwania ani aktualizacji. Doręczenia mogą być ponawiane przez platformę i mogą pojawić się więcej niż raz dla tego samego zdarzenia. Deduplikacja powinna odbywać się po polu event_id.

curl "https://api-sandbox.emfakt.com/v1/control-plane/webhook-endpoints/we_zp8wM2uUYWcKiM5xdATxAg/deliveries" \  -H "Authorization: Bearer <access_token>"

{  "data": [    {      "id": "wd_2kCYq4m4G7YbUjvH0kC1dg",      "object": "webhook_delivery",      "event_id": "evt_V3sGDb5VXxLxzGzvYVw0Pw",      "event_type": "invoice.accepted",      "endpoint_id": "we_zp8wM2uUYWcKiM5xdATxAg",      "status": "succeeded",      "attempt_count": 1,      "last_http_status": 200,      "last_error_summary": null,      "next_retry_at": null,      "created_at": "2026-06-01T10:18:30Z",      "updated_at": "2026-06-01T10:18:31Z",      "last_attempted_at": "2026-06-01T10:18:31Z",      "delivered_at": "2026-06-01T10:18:31Z"    },    {      "id": "wd_6DnDrtNabjwjYH8NfRMSnQ",      "object": "webhook_delivery",      "event_id": "evt_XjW1g8KMqJj6fW3Az7bXzQ",      "event_type": "invoice.upo_available",      "endpoint_id": "we_zp8wM2uUYWcKiM5xdATxAg",      "status": "retrying",      "attempt_count": 1,      "last_http_status": 500,      "last_error_summary": "Webhook endpoint returned HTTP 500.",      "next_retry_at": "2026-06-01T10:19:31Z",      "created_at": "2026-06-01T10:18:30Z",      "updated_at": "2026-06-01T10:18:31Z",      "last_attempted_at": "2026-06-01T10:18:31Z",      "delivered_at": null    }  ]}

Statusy doręczeń

Status pokazuje aktualny stan wysyłki webhooka do konkretnego endpointu. Uwzględnia wszystkie wykonane próby doręczenia. Od oczekiwania na wysyłkę aż do jej powodzenia, trwałego niepowodzenia lub wyłączenia endpointu.

Obiekt WebhookDelivery

Każdy obiekt reprezentuje doręczenie jednego zdarzenia do konkretnego endpointu webhooka. Pole last_error_summary zawiera krótki opis ostatniego błędu, na przykład Webhook endpoint returned HTTP 500.

Treść odpowiedzi zwróconej przez endpoint nie jest zapisywana ani udostępniana. System przechowuje wyłącznie informacje potrzebne do określenia wyniku doręczenia.