Langsung ke konten
Sursa Developers

Peristiwa · Kartu

card.index_failed

Pengindeksan kartu gagal

Pengindeksan versi kartu gagal (data.reason adalah kode netral). Kartu mempertahankan status error sampai diunggah atau diindeks ulang lagi.

Jenis objek
card
Dikirim ke
Webhook yang dapat melihat objek: menurut peran, profil data, dan koleksi

Payload

Objek: EventCardIndexFailed

  • idstringwajib

    ID peristiwa (evt_…), juga dikirim sebagai header webhook-id. Gunakan untuk membuang pengiriman duplikat.

  • typestringwajib

    Nilai yang diizinkan: card.index_failed

  • created_atstring (date-time)wajib

    Kapan perubahan terjadi (UTC).

  • org_idintegerwajib
  • api_versionstringwajib

    Versi kontrak skema data.

  • sequenceinteger

    Nomor urut pengiriman dalam webhook (tidak ada untuk peristiwa uji).

  • payloadstringwajib

    thin berarti tanpa data: baca objek melalui API.

    Nilai yang diizinkan: fullthin

  • dataobject
    Field
    • cardEventCardwajib
    • job_idinteger | null

      Job pengindeksan atau ekspor.

    • versionintegerwajib
    • reasonstringwajib

      Kode alasan netral (enum yang dapat bertambah: perlakukan kode yang tidak dikenal sebagai kegagalan umum). Contoh: unprocessable, too_large, timeout, upstream_unavailable, internal.

  • testbooleanwajib

    Peristiwa uji yang dikirim oleh POST /v1/webhooks/{webhook_id}/test.

Contoh pengiriman

{
  "id": "evt_0123456789abcdef0123456789abcdef",
  "type": "card.index_failed",
  "created_at": "2026-10-24T10:00:03Z",
  "org_id": 1,
  "api_version": "1.62.0",
  "sequence": 1042,
  "object": {
    "type": "card",
    "id": "c_9f2e41"
  },
  "payload": "full",
  "data": {
    "card": {
      "id": "c_9f2e41",
      "title": "Refund policy",
      "collection": "support",
      "collection_id": 3,
      "version": 4,
      "kind": "text",
      "status": "error",
      "verification_state": "trusted",
      "owner_id": 7,
      "tags": [
        "billing"
      ],
      "external_id": null,
      "metadata": {}
    },
    "job_id": 4410,
    "version": 4,
    "reason": "unprocessable"
  },
  "test": false
}

Menerima peristiwa

Setiap pengiriman adalah permintaan POST dengan isi JSON ini ke URL penerima webhook Anda. Periksa header webhook-signature (Standard Webhooks) sebelum Anda memercayai isinya, jawab dengan status 2xx dalam beberapa detik, lalu kerjakan prosesnya sesudahnya. Pengiriman ke satu webhook mempertahankan urutan peristiwa; pengiriman yang gagal dicoba ulang dengan jeda yang makin panjang.

Jenis peristiwa baru dan field baru dapat muncul kapan saja: lewati jenis dan field yang tidak Anda kenal.

Peristiwa yang sama tersedia di umpan peristiwa selama 30 hari →