الانتقال إلى المحتوى الرئيسي
POST
curl
كل استدعاء يُعيد إرسال الـ webhook مرة أخرى. اجعل endpoint الخاص بك idempotent بناءً على event_id قبل إعادة الإرسال بالجملة، ولا تُعد إرسال إلا التسليمات التي تكون قيمة response_status فيها null أو 400 أو أعلى.
تُرسَل إعادة الإرسال إلى الرابط نفسه الذي استخدمه التسليم الأصلي. إذا نقلت الوجهة إلى رابط جديد، فستظل التسليمات القديمة تشير إلى الرابط القديم. اعثر على التسليمات التي تريد إعادة إرسالها باستخدام قائمة تسليمات وجهة webhook، وراجع دليل webhook للتحقق من التوقيع.

التفويضات

x-api-key
string
header
مطلوب

مفتاح API الخاص بتطبيقك، من Developers -> API keys في Business Console. يمتلك المفتاح الأساسي وصولاً كاملاً. يمكن تحديد نطاق المفتاح المسمى: لا شيء، أو قراءة، أو كتابة لكل مورد، ومحدوداً ببعض مسارات العمل أو بالجلسات المقبولة، وبقائمة من عناوين IP، وبتاريخ انتهاء الصلاحية. يشير 401 إلى أن المفتاح غير صحيح أو ملغى أو منتهي الصلاحية؛ ويشير 403 إلى أنه لم يتم إرسال أي مفتاح، أو أن المفتاح ليس لديه حق الوصول إلى هذا المورد أو الإجراء، أو أن الطلب جاء من عنوان خارج قائمة عناوين IP الخاصة به؛ ويشير 404 في مسار جلسة إلى أن الجلسة خارج مسارات العمل أو الحالات الخاصة بالمفتاح. يتلقى المفتاح الذي لا يمتلك حق الوصول إلى الوسائط عناوين URL للصور ومقاطع الفيديو وملفات PDF كـ null، ويتلقى المفتاح الذي لا يمتلك إذن كتابة للجلسات روابط الجلسة وtoken كـ null. راجع https://docs.didit.me/console/api-keys.

معلمات المسار

destination_uuid
string<uuid>
مطلوب

معرّف UUID للوجهة التي تم إرسال عملية التسليم إليها.

delivery_uuid
string<uuid>
مطلوب

معرّف UUID لعملية التسليم المراد إعادة إرسالها: وهو الـ uuid لمدخل تم إرجاعه بواسطة GET /v3/webhook/destinations/{destination_uuid}/deliveries/.

الاستجابة

التسليم الجديد، الذي جرت محاولته بالفعل. تمثل response_status ما أجاب به endpoint الخاص بك هذه المرة (504 انتهاء المهلة، 503 فشل الاتصال). يظل التسليم الأصلي دون تغيير.

محاولة تسليم واحدة إلى وجهة webhook، مع رؤوس وجسم الطلب الفعليين اللذين أرسلتهما Didit تماماً.

uuid
string<uuid>
مطلوب

معرّف التسليم، لطلبات التفاصيل وإعادة الإرسال.

session_id
string<uuid> | null
مطلوب

جلسة التحقق من المستخدمين التي يتعلق بها الحدث. null لأحداث جلسة الشركة، والمستخدم، والشركة، والمعاملة، وTravel Rule، وسير العمل.

request_url
string<uri> | null
مطلوب

رابط URL الذي أُرسل إليه التسليم: رابط URL الخاص بالوجهة عند إنشاء الحدث.

response_status
integer | null
مطلوب

حالة HTTP التي أرجعها الـ endpoint الخاص بك. null طالما أن التسليم في قائمة الانتظار ولم تتم محاولته بعد. عندما لا يتم تلقي أي استجابة HTTP، تسجل Didit حالة خاصة بها: 504 عندما لم يُجب الـ endpoint الخاص بك في غضون 5 ثوانٍ، و503 لفشل الاتصال، و400 عندما تم رفض عنوان URL لعدم أمانه (على سبيل المثال عنوان خاص أو داخلي)، و404 لأي خطأ آخر في الطلب. يُعتبر الرمز 400 أو أعلى تسليمًا فاشلاً.

response_time_ms
integer | null
مطلوب

الوقت الذي استغرقته المحاولة بالمللي ثانية. يكون null عندما يكون التسليم في قائمة الانتظار.

النطاق المطلوب: x >= 0
status
string | null
مطلوب

الحالة التي أبلغ عنها الحدث عند إنشائه: حالة الجلسة لأحداث الجلسة (على سبيل المثال Approved أو In Review)، وحالة الشخص أو الشركة لأحداث المستخدم والشركة، وحالة المعاملة لأحداث المعاملات. وتكون null للأحداث التي لا تحمل أي حالة.

webhook_type
enum<string>
مطلوب

اسم حدث webhook المدعوم. استخدم هذه النصوص بدقة في subscribed_events؛ حيث يتم رفض القيم غير المدعومة.

الخيارات المتاحة:
status.updated,
data.updated,
user.status.updated,
user.data.updated,
business.status.updated,
business.data.updated,
activity.created,
transaction.created,
transaction.status.updated,
travel_rule.status.updated,
workflow.compliance_changed,
transaction_rule_suggestions.created,
auth.signup,
auth.login,
auth.login_failed,
auth.password_reset_requested,
auth.password_reset_completed,
auth.mfa_changed,
auth.new_device,
auth.account_locked,
investigator.report.ready,
investigator.decision.automated,
investigator.decision.overridden,
investigator.decision.contested,
investigator.question.raised,
investigator.automation.paused,
investigator.rfi.answered,
investigator.rfi.overdue,
investigator.drift.detected,
investigator.sla.breached,
investigator.qa.failed,
investigator.external.report.ready
created_at
string<date-time>
مطلوب

وقت إنشاء التسليم.

request_header
string
مطلوب

نص JSON (سلسلة نصية) لرؤوس الطلب التي أرسلتها Didit: وهي Content-Type وX-Signature وX-Signature-V2 وX-Signature-Simple وX-Timestamp وUser-Agent. قم بتحليله باستخدام محلل JSON. يحتوي على التوقيعات، ولا يحتوي أبداً على سر التوقيع.

request_body
string
مطلوب

نص JSON (سلسلة نصية) للـ payload الدقيق الذي أرسلته Didit، مع فرز المفاتيح، بما في ذلك event_id وtimestamp. قم بتحليله باستخدام محلل JSON؛ راجع شكل الـ Payload. بالنسبة لمفتاح محدد النطاق بدون media: read، تكون عناوين URL للوسائط بداخله null؛ وبدون sessions: write، تكون رموز الجلسات وروابط التحقق المستضافة null. محتوى الطلب الذي تم تغييره بهذه الطريقة لا يعود مطابقاً لتوقيعاته. لا تسجل Didit محتوى الاستجابة الذي أرجعه الـ endpoint الخاص بك.

آخر تعديل في ٧ نوفمبر ٢٠٢٦