Przejdź do treści
Sursa Developers

Zdarzenia · Rozliczenia

credits.low

Kończą się kredyty

Saldo kredytów w okresie przekroczyło próg wykorzystania (data.threshold – procent wykorzystanej puli). Wysyłane raz dla każdego progu i okresu.

Typ obiektu
org
Odbiorcy
Webhooki z rolą administratora

Treść zdarzenia

Obiekt: EventCreditsLow

  • idstringwymagane

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

  • typestringwymagane

    Dozwolone wartości: credits.low

  • 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
    • thresholdintegerwymagane

      Próg w procentach wykorzystanej puli: 80 lub 100.

    • period_startstring (date)wymagane
    • balancenumber
    • allowancenumber
  • testbooleanwymagane

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

Przykładowe dostarczenie

{
  "id": "evt_0123456789abcdef0123456789abcdef",
  "type": "credits.low",
  "created_at": "2026-10-24T10:00:03Z",
  "org_id": 1,
  "api_version": "1.62.0",
  "sequence": 1042,
  "object": {
    "type": "org",
    "id": "1"
  },
  "payload": "full",
  "data": {
    "threshold": 80,
    "period_start": "2026-10-01",
    "balance": 1000,
    "allowance": 5000
  },
  "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 →