للمطورين

Webhooks

دع Chaos يخبر خادمك عند وصول ردّ أو فتح نموذج أو إغلاقه.

الـ webhook عنوان على خادمك يتصل به Chaos عند حدوث شيء. وهو اختياري: يعمل Chaos والتطبيقات المتصلة بالكامل بدونه.

ما يستطيع Chaos إخبارك به

• إرسال ردّ: أنهى أحدهم نموذجًا أو اختبارًا.
• تصحيح ردّ: غيّرت درجة إجابة في اختبار.
• النشر والإغلاق وإعادة الفتح: تغيّرت حالة نموذج أو اختبار.

أضف webhook

1. افتح الاتصالات من الشريط الجانبي. قسم Webhooks تحت اتصالاتك.
2. اضغط Webhook جديد وأدخل عنوان خادمك. يجب أن يبدأ بـ https://.
3. علّم على الأحداث التي تريدها.
4. اختر كل نماذجي واختباراتي أو التي أختارها فقط.
5. اضغط أنشئ الـ webhook، ثم انسخ سرّ التوقيع إلى إعدادات خادمك. يعرضه Chaos مرة واحدة.
6. اضغط أرسل تجربة لتتأكد أن خادمك يستقبله ويقبل التوقيع.

ما الذي يُرسل

افتراضيًا يرسل Chaos معرّفات وأعدادًا ودرجات وأوقاتًا، ولا يرسل ما أجاب به الناس أبدًا. لا تعلّم على أرسل الإجابات وأسماء المجيبين إلا إن كان مسموحًا لخادمك حفظ بيانات شخصية. والـ webhooks التي ينشئها تطبيق متصل لا تتضمن الإجابات أبدًا.

التواقيع والأسرار

كل إرسال موقَّع بسرّ الـ webhook، ليتحقق خادمك أنه من Chaos وأنه حديث. سرّ جديد ينشئ سرًّا جديدًا، ويبقى القديم صالحًا 24 ساعة لتنتقل دون أن يفوتك شيء.

لا يتصل Chaos إلا بعناوين عامة، ويرفض العناوين داخل الشبكات الخاصة.

السجل والفشل

• سجل الإرسال يعرض الإرسالات الأخيرة ونتيجتها. اضغط أعد الإرسال لإرسال أحدها مرة أخرى.
• إن لم يستجب خادمك يحاول Chaos مجددًا نحو 15 ساعة، وينتظر أطول في كل مرة.
• بعد 25 فشلًا متتاليًا يتوقف الـ webhook ويصلك إشعار. أصلح خادمك ثم اضغط استأنف.
• أوقف مؤقتًا يوقف الإرسال حتى تستأنفه. احذف يزيل الـ webhook وسجله.

للمطورين: شكل البيانات وطريقة التحقق من التوقيع في وثيقة الـ webhooks، الإصدار 1 (بالإنجليزية).