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

الأحداث · المصادر والاستيراد

source.sync_failed

فشلت مزامنة مصدر

فشلت مزامنة مصدر (الحقل data.reason رمز محايد).

نوع الكائن
source
يُسلَّم إلى
خطافات الويب ذات دور المشرف

الحمولة

الكائن: EventSourceSyncFailed

  • idstringمطلوب

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

  • typestringمطلوب

    القيم المسموح بها: source.sync_failed

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

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

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

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

  • sequenceinteger

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

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

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

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

  • dataobject
    الحقول
    • sourceEventSourceمطلوب
    • syncEventSyncمطلوب
    • reasonstringمطلوب

      رمز سبب محايد (تعداد قابل للتوسيع: تعامل مع الرمز غير المعروف بوصفه إخفاقًا عامًا). القيم: sync_failed، وdestination_forbidden.

  • testbooleanمطلوب

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

مثال تسليم

{
  "id": "evt_0123456789abcdef0123456789abcdef",
  "type": "source.sync_failed",
  "created_at": "2026-10-24T10:00:03Z",
  "org_id": 1,
  "api_version": "1.62.0",
  "sequence": 1042,
  "object": {
    "type": "source",
    "id": "5"
  },
  "payload": "full",
  "data": {
    "source": {
      "id": 5,
      "name": "Wiki",
      "kind": "confluence",
      "collection_id": 3
    },
    "sync": {
      "run_id": 902,
      "status": "error",
      "stats": {
        "listed": 120,
        "added": 3,
        "updated": 5,
        "unchanged": 112,
        "removed": 0,
        "errors": 0
      }
    },
    "reason": "sync_failed"
  },
  "test": false
}

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

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

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

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