İçeriğe geç
Sursa Developers

Olaylar · İşler ve dışa aktarmalar

job.failed

İş başarısız oldu

Bir arka plan işi başarısız oldu ya da iptal edildi (data.reason nötr bir koddur).

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

Veri yükü

Nesne: EventJobFailed

  • 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: job.failed

  • 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
    • jobEventJobzorunlu
    • reasonstringzorunlu

      Nötr neden kodu (genişletilebilir sabit değer listesi: bilinmeyen bir kodu genel bir hata olarak değerlendirin). Örnekler: canceled, timeout, unprocessable, internal.

  • testbooleanzorunlu

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

Örnek teslim

{
  "id": "evt_0123456789abcdef0123456789abcdef",
  "type": "job.failed",
  "created_at": "2026-10-24T10:00:03Z",
  "org_id": 1,
  "api_version": "1.62.0",
  "sequence": 1042,
  "object": {
    "type": "job",
    "id": "4410"
  },
  "payload": "full",
  "data": {
    "job": {
      "id": 4410,
      "kind": "index",
      "status": "error",
      "card_id": "c_9f2e41",
      "collection": "support",
      "batch_id": null,
      "title": "Refund policy.pdf",
      "finished_at": "2026-10-24T10:00:03Z"
    },
    "reason": "timeout"
  },
  "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 →