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

الأحداث · الأسئلة والإجابات

question.feedback_created

قُيِّمت إجابة

قيّم مستخدم إجابة (data.feedback.value: القيمة 1 مفيدة، والقيمة -1 غير مفيدة).

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

الحمولة

الكائن: EventQuestionFeedbackCreated

  • idstringمطلوب

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

  • typestringمطلوب

    القيم المسموح بها: question.feedback_created

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

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

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

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

  • sequenceinteger

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

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

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

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

  • dataobject
    الحقول
    • questionEventQuestionمطلوب
    • answer_idstring | nullمطلوب
    • feedbackobjectمطلوب
      الحقول
      • valueintegerمطلوب

        القيم المسموح بها: -11

      • reasonstring | nullمطلوب

        سبب التقييم السلبي.

    • actor_idinteger | nullمطلوب

      المستخدم الذي نفّذ الإجراء؛ والقيمة null لمفتاح API للمؤسسة أو للمنصة نفسها.

  • testbooleanمطلوب

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

مثال تسليم

{
  "id": "evt_0123456789abcdef0123456789abcdef",
  "type": "question.feedback_created",
  "created_at": "2026-10-24T10:00:03Z",
  "org_id": 1,
  "api_version": "1.62.0",
  "sequence": 1042,
  "object": {
    "type": "question",
    "id": "3051"
  },
  "payload": "full",
  "data": {
    "question": {
      "id": 3051,
      "user_id": 7
    },
    "answer_id": "a_51c0",
    "feedback": {
      "value": -1,
      "reason": "outdated"
    },
    "actor_id": 7
  },
  "test": false
}

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

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

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

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