الانتقال إلى المحتوى الرئيسي
GET
curl
عمليات التسليم هي المحاولات التي أجرتها Didit لإرسال webhook إلى هذه الوجهة. تتبع عمليات إعادة المحاولة التلقائية سياسة إعادة المحاولة ويظهر كل منها كإدخال مستقل. لإعادة إرسال عملية تسليم بعد إصلاح الـ endpoint لديك، استدعِ إعادة إرسال تسليم وجهة 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 للوجهة (الـ uuid المُرجع بواسطة GET /v3/webhook/destinations/).

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

limit
integer
افتراضي:50

الحد الأقصى لعدد عمليات التسليم لكل صفحة. القيمة الافتراضية هي 50. أي قيمة ليست عدداً صحيحاً موجباً تعود تلقائياً إلى 50؛ وأي قيمة تزيد عن 1000000 تُرجع 400.

النطاق المطلوب: 1 <= x <= 1000000
offset
integer
افتراضي:0

عدد عمليات التسليم المراد تخطيها. القيمة الافتراضية هي 0. يُفضّل تتبّع رابطي next وprevious من الاستجابة.

النطاق المطلوب: 0 <= x <= 1000000
date_from
string<date>

أول يوم بتوقيت UTC لتضمينه، بالصيغة YYYY-MM-DD (شاملاً ذلك اليوم). اتركه فارغاً للبدء من أقدم تسليم متاح. يُقبل dateFrom كاسم بديل.

date_to
string<date>

آخر يوم بتوقيت UTC يتم تضمينه، بصيغة YYYY-MM-DD (شامل). يجب ألا يكون أقدم من date_from. يُقبل dateTo كاسم بديل.

الاستجابة

صفحة واحدة من عمليات التسليم، الأحدث أولاً.

count
integer
مطلوب

عمليات التسليم المطابقة، دقيقة حتى 100 وبحد أقصى 100 بعد ذلك. استخدم next لمعرفة ما إذا كانت هناك صفحات إضافية.

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

رابط URL مطلق للصفحة التالية، أو null في الصفحة الأخيرة.

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

رابط URL مطلق للصفحة السابقة، أو null في الصفحة الأولى.

results
object[]
مطلوب
آخر تعديل في ٧ نوفمبر ٢٠٢٦