التوثيق
مرجع واجهة API لـ Webhook
تسليم أحداث موقَّع مرة واحدة على الأقل، مع السجل وإعادة التشغيل
الوجهات
تتيح عشرة مسارات تتطلب المصادقة إنشاء الوجهات وسردها وفحصها وتحديثها وتدوير أسرارها واختبارها وحذفها، إضافة إلى قراءة الإعدادات وسجل التسليم وإعادة تشغيل تسليم واحد. وتبقى مرشحات الوجهات ضمن حقوق الحساب النشطة للدول ومجموعات البيانات. حدود وجهات Webhook هي 1 لخطة Free، و3 لخطة Basic، و10 لخطة Pro.
أحداث التنبؤ
تتلقى الوجهات التي تتضمن عائلة predictions إشعار prediction.event.closed عند توقف التداول على حدث، وإشعار prediction.event.settled عند تسوية الحدث أو إلغائه. نرسل كلًا منهما مرة واحدة على الأكثر لكل حدث. يحتوي متن الرسالة على حالة الحدث، ولا يتضمن أبدًا احتمالًا أو النتيجة الفائزة.
التوقيعات وإعادة المحاولة
تحقّق من x-narwhal-signature باعتباره HMAC-SHA256 محسوبًا على timestamp + "." + raw_body. يتم التسليم مرة واحدة على الأقل. لا تُعِد استجابة 2xx إلا بعد إتمام معالجة دائمة، وأزل التكرار حسب معرّف التسليم.
السجل وإعادة التشغيل
يسجل سجل التسليم حالة كل محاولة وحالة الاستجابة. وتُنشئ إعادة التشغيل تسليمًا جديدًا للحدث نفسه غير القابل للتغيير. ويتضمن تدوير السر فترة تداخل تتيح للمستقبِلين التحقق من أيٍّ من التوقيعين المعلنين.