Chuyển tới nội dung
Sursa Developers

Sự kiện · Thẻ

card.updated

Đã cập nhật thẻ

Trường hoặc nội dung của thẻ đã thay đổi: chỉnh sửa thông tin thẻ, nhãn, người phụ trách, phiên bản mới của tệp hoặc văn bản, một bản nháp được xuất bản thành phiên bản mới, hoặc quá trình xử lý đã gán danh mục truy cập cho thẻ (data.previous_attributes.category là _unclassified: thẻ đang chờ phân loại và giờ đã khả dụng với những bên nhận có hồ sơ dữ liệu cho phép truy cập danh mục của thẻ). data.previous_attributes chứa giá trị trước của các trường đã thay đổ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: EventCardUpdated

  • idstringbắt buộc

    ID sự kiện (evt_…), cũng được gửi trong header webhook-id. Dùng nó để loại bỏ các lần gửi trùng lặp.

  • typestringbắt buộc

    Giá trị cho phép: card.updated

  • created_atstring (date-time)bắt buộc

    Thời điểm xảy ra thay đổi (UTC).

  • org_idintegerbắt buộc
  • api_versionstringbắt buộc

    Phiên bản hợp đồng của lược đồ data.

  • sequenceinteger

    Số thứ tự lần gửi trong phạm vi webhook (không có với sự kiện thử).

  • objectWebhookEventObjectbắt buộc
  • payloadstringbắt buộc

    thin nghĩa là không có data: hãy đọc đối tượng qua API.

    Giá trị cho phép: fullthin

  • dataobject
    Trường
    • cardEventCardbắt buộc
    • actor_idinteger | nullbắt buộc

      Người dùng đã thực hiện hành động; null với khóa API của tổ chức hoặc chính nền tảng.

    • previous_attributesobjectbắt buộc

      Giá trị trước đây của các trường cấp cao nhất đã thay đổi của đối tượng.

    • job_idinteger | null

      Tác vụ lập chỉ mục hoặc tác vụ xuất.

    • verified_on_publishboolean

      Bản nháp đã được xuất bản ở trạng thái đã kiểm chứng.

  • testbooleanbắt buộc

    Sự 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.updated",
  "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": "ready",
      "verification_state": "trusted",
      "owner_id": 7,
      "tags": [
        "billing"
      ],
      "external_id": null,
      "metadata": {}
    },
    "actor_id": 7,
    "previous_attributes": {
      "title": "Refunds"
    }
  },
  "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 →