Przejdź do treści
Sursa Developers

Zdarzenia · Zdarzenia usługowe webhooków

webhook.endpoint_disabled

Wyłączono webhook

Webhook został wstrzymany po powtarzających się niepowodzeniach lub wyłączony (data.state: paused | disabled; data.reason: failures | gone | manual | feature_disabled).

Typ obiektu
webhook
Odbiorcy
Webhooki z rolą administratora

Treść zdarzenia

Obiekt: EventWebhookEndpointDisabled

  • idstringwymagane

    ID zdarzenia (evt_…), wysyłany także jako nagłówek webhook-id. Używaj go do odrzucania zduplikowanych dostarczeń.

  • typestringwymagane

    Dozwolone wartości: webhook.endpoint_disabled

  • created_atstring (date-time)wymagane

    Kiedy nastąpiła zmiana (UTC).

  • org_idintegerwymagane
  • api_versionstringwymagane

    Wersja kontraktu schematu data.

  • sequenceinteger

    Numer kolejny dostarczenia w obrębie webhooka (brak dla zdarzenia testowego).

  • objectWebhookEventObjectwymagane
  • payloadstringwymagane

    thin oznacza brak data: odczytaj obiekt przez API.

    Dozwolone wartości: fullthin

  • dataobject
    Pola
    • endpoint_idintegerwymagane
    • statestringwymagane

      paused lub disabled.

    • reasonstringwymagane

      failures, gone, manual lub feature_disabled.

  • testbooleanwymagane

    Zdarzenie testowe wysłane przez POST /v1/webhooks/{webhook_id}/test.

Przykładowe dostarczenie

{
  "id": "evt_0123456789abcdef0123456789abcdef",
  "type": "webhook.endpoint_disabled",
  "created_at": "2026-10-24T10:00:03Z",
  "org_id": 1,
  "api_version": "1.62.0",
  "sequence": 1042,
  "object": {
    "type": "webhook",
    "id": "4"
  },
  "payload": "full",
  "data": {
    "endpoint_id": 4,
    "state": "paused",
    "reason": "failures"
  },
  "test": false
}

Odbieranie zdarzeń

Każde dostarczenie to żądanie POST z tą treścią JSON wysyłane na adres odbiorcy Twojego webhooka. Zanim zaufasz treści, zweryfikuj nagłówek webhook-signature (Standard Webhooks), odpowiedz statusem 2xx w ciągu kilku sekund, a właściwą pracę wykonaj później. Dostarczenia do jednego webhooka zachowują kolejność zdarzeń; nieudane dostarczenie jest ponawiane z coraz dłuższymi przerwami.

Nowe typy zdarzeń i nowe pola mogą pojawić się w każdej chwili: pomijaj typy i pola, których nie znasz.

Te same zdarzenia są dostępne w kanale zdarzeń przez 30 dni →