İçeriğe geç
Sursa Developers

Olaylar · Faturalandırma

credits.low

Krediler azalıyor

Dönemin kredi bakiyesi bir kullanım eşiğini geçti (data.threshold, kullanılan kullanım hakkının yüzdesi). Her eşik ve dönem için bir kez gönderilir.

Nesne türü
org
Teslim edilen webhook’lar
admin rolüne sahip webhook’lar

Veri yükü

Nesne: EventCreditsLow

  • idstringzorunlu

    Olay kimliği (evt_…); webhook-id başlığı olarak da gönderilir. Yinelenen teslimleri ayıklamak için kullanın.

  • typestringzorunlu

    Geçerli değerler: credits.low

  • created_atstring (date-time)zorunlu

    Değişikliğin gerçekleştiği zaman (UTC).

  • org_idintegerzorunlu
  • api_versionstringzorunlu

    data şemasının sözleşme sürümü.

  • sequenceinteger

    Webhook içindeki teslim sıra numarası (test olayında yoktur).

  • objectWebhookEventObjectzorunlu
  • payloadstringzorunlu

    thin, data olmadığı anlamına gelir: nesneyi API üzerinden okuyun.

    Geçerli değerler: fullthin

  • dataobject
    Alanlar
    • thresholdintegerzorunlu

      Eşik, kullanım hakkının kullanılan yüzdesi olarak: 80 ya da 100.

    • period_startstring (date)zorunlu
    • balancenumber
    • allowancenumber
  • testbooleanzorunlu

    POST /v1/webhooks/{webhook_id}/test ile gönderilen test olayı.

Örnek teslim

{
  "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
}

Olayları alma

Her teslim, bu JSON gövdesiyle webhook’unuzun URL’sine gönderilen bir POST isteğidir. Gövdeye güvenmeden önce webhook-signature başlığını (Standard Webhooks) doğrulayın, birkaç saniye içinde 2xx durumuyla yanıt verin ve işi daha sonra yapın. Bir webhook’a yapılan teslimler olayların sırasını korur; başarısız bir teslim giderek uzayan aralarla yeniden denenir.

Yeni olay türleri ve yeni alanlar her an ortaya çıkabilir: bilmediğiniz türleri ve alanları atlayın.

Aynı olaylar 30 gün boyunca olay beslemesinde de yer alır →