انتقل إلى المحتوى
Sursa Developers

الأحداث · البطاقات

card.index_failed

فشلت فهرسة بطاقة

فشلت فهرسة إصدار من البطاقة (الحقل data.reason رمز محايد). تحتفظ البطاقة بحالة الخطأ حتى تُرفع أو تُعاد فهرستها مرة أخرى.

نوع الكائن
card
يُسلَّم إلى
خطافات الويب التي ترى الكائن: حسب الدور وملف تعريف البيانات والمجموعات

الحمولة

الكائن: EventCardIndexFailed

  • idstringمطلوب

    معرّف الحدث (evt_…)، ويُرسَل أيضًا في الترويسة webhook-id. استخدمه لإسقاط التسليمات المكررة.

  • typestringمطلوب

    القيم المسموح بها: card.index_failed

  • created_atstring (date-time)مطلوب

    وقت حدوث التغيير (UTC).

  • org_idintegerمطلوب
  • api_versionstringمطلوب

    إصدار العقد لمخطط data.

  • sequenceinteger

    الرقم التسلسلي للتسليم ضمن خطاف الويب (يغيب في الحدث التجريبي).

  • objectWebhookEventObjectمطلوب
  • payloadstringمطلوب

    القيمة thin تعني بلا data: اقرأ الكائن عبر API.

    القيم المسموح بها: fullthin

  • dataobject
    الحقول
    • cardEventCardمطلوب
    • job_idinteger | null

      مهمة الفهرسة أو التصدير.

    • versionintegerمطلوب
    • reasonstringمطلوب

      رمز سبب محايد (تعداد قابل للتوسيع: تعامل مع الرمز غير المعروف بوصفه إخفاقًا عامًا). أمثلة: unprocessable، وtoo_large، وtimeout، وupstream_unavailable، وinternal.

  • testbooleanمطلوب

    حدث تجريبي أرسلته العملية POST /v1/webhooks/{webhook_id}/test.

مثال تسليم

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

استقبال الأحداث

كل تسليم هو طلب POST بنص JSON كهذا إلى عنوان خطاف الويب لديك. تحقّق من الترويسة webhook-signature (Standard Webhooks) قبل أن تثق بالنص، وأجب بحالة 2xx خلال ثوانٍ قليلة، ثم نفّذ العمل بعد ذلك. تحافظ التسليمات إلى خطاف ويب واحد على ترتيب الأحداث، ويُعاد التسليم الفاشل بفواصل زمنية متزايدة.

قد تظهر أنواع أحداث جديدة وحقول جديدة في أي وقت: تجاهل الأنواع والحقول التي لا تعرفها.

الأحداث نفسها في سجل الأحداث لمدة 30 يومًا ←