Sự kiện · Thẻ
card.index_failed
Lập chỉ mục thẻ thất bại
Việc lập chỉ mục một phiên bản thẻ đã thất bại (data.reason là một mã trung tính). Thẻ giữ trạng thái lỗi cho đến khi được tải lên lại hoặc lập chỉ mục lại.
- Loại đối tượng
- card
- Gửi tới
- Webhook nhìn thấy được đối tượng: theo vai trò, hồ sơ dữ liệu và bộ sưu tập
Payload
Đối tượng: EventCardIndexFailed
idstringbắt buộcID sự kiện (
evt_…), cũng được gửi trong headerwebhook-id. Dùng nó để loại bỏ các lần gửi trùng lặp.typestringbắt buộcGiá trị cho phép:
card.index_failedcreated_atstring (date-time)bắt buộcThời điểm xảy ra thay đổi (UTC).
org_idintegerbắt buộcapi_versionstringbắt buộcPhiên bản hợp đồng của lược đồ
data.sequenceintegerSố thứ tự lần gửi trong phạm vi webhook (không có với sự kiện thử).
payloadstringbắt buộcthinnghĩa là không códata: hãy đọc đối tượng qua API.Giá trị cho phép:
fullthindataobjectTrường
job_idinteger | nullTác vụ lập chỉ mục hoặc tác vụ xuất.
versionintegerbắt buộcreasonstringbắt buộcMã lý do trung tính (tập giá trị có thể mở rộng: hãy coi mã không xác định là lỗi chung). Ví dụ:
unprocessable,too_large,timeout,upstream_unavailable,internal.
testbooleanbắt buộcSự kiện thử được gửi bằng
POST /v1/webhooks/{webhook_id}/test.
Ví dụ một lần gửi
{
"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
}Nhận sự kiện
Mỗi lần gửi là một yêu cầu POST với phần thân JSON này tới webhook của bạn. Xác minh header webhook-signature (Standard Webhooks) trước khi tin vào phần thân, trả lời bằng trạng thái 2xx trong vài giây và xử lý công việc sau đó. Các lần gửi tới một webhook giữ đúng thứ tự sự kiện; lần gửi thất bại được thử lại với khoảng chờ tăng dần.
Loại sự kiện mới và trường mới có thể xuất hiện bất cứ lúc nào: hãy bỏ qua các loại và trường bạn không biết.
Các sự kiện này cũng có trong nguồn cấp sự kiện trong 30 ngày →