عرض محاولات التسليم
عرض محاولات التسليم
GET
/v1/projects/{projectId}/webhook-endpoints/{id}/deliveriesتدعم هذه العملية مصادقة ملف ارتباط جلسة لوحة التحكم. استدعها من شيفرة خادم موثوقة فقط، ولا تنشئ المتصفحات ملف الجلسة أو تكشفه.
تقسيم بمؤشر مفتاحي مرتب تنازليًا حسب created_at ثم id، مع مرشحي state وeventType. يحتاج المفتاح إلى read أو write، أو جلسة لوحة التحكم.
حد المعدّل: 60 طلبًا لكل 60 ثانية لكل مستدعٍ.
رموز الخطأ: unauthorized (401), insufficient_scope (403),
endpoint_not_found (404), invalid_state (400).
المصادقة
- apiKey — مفتاح المشروع في ترويسة
Authorization: Bearerبصيغةvh_live_...للوضع الفعلي أوvh_test_...للوضع التجريبي، ويحمل صلاحيةreadو/أوwrite. - sessionCookie — ملف ارتباط جلسة لوحة التحكم الذي يضبطه
POST /v1/auth/login. تتطلب مسارات الفيديو والتشغيل أيضًا معاملprojectIdعند استخدام الجلسة.
المعاملات
| الاسم | الموضع | النوع | إلزامي | الوصف |
|---|---|---|---|---|
projectId | path | string (Ulid) | نعم | — |
id | path | string (Ulid) | نعم | — |
limit | query | integer | لا | — |
cursor | query | string | لا | مؤشر غير شفاف أعادته الصفحة السابقة في nextCursor. |
state | query | string (WebhookDeliveryState) | لا | يرشّح النتائج حسب حالة التسليم. |
eventType | query | string | لا | يرشّح النتائج حسب نوع الحدث الخارجي. |
جسم الطلب
لا تأخذ هذه العملية جسم طلب.
الاستجابات
| الرمز | المعنى |
|---|---|
200 | صفحة واحدة من محاولات التسليم. |
400 | فشل التحقق من جسم الطلب أو معاملاته. يذكر وصف العملية قيم error.code الدقيقة. |
401 | لم تُقدَّم بيانات اعتماد صالحة. |
403 | بيانات الاعتماد صالحة لكنها لا تسمح بهذا الإجراء. يذكر وصف العملية قيم error.code الدقيقة. |
404 | المورد غير موجود أو غير مرئي لهذا المستدعي. |
429 | تم تجاوز حد المعدّل. |
جرّبها
GET
/v1/projects/{projectId}/webhook-endpoints/{id}/deliveriesوضع الاختبار فقط
منصة API التفاعلية
أرسل طلبًا حيًا إلى api.videohati.com بمفتاح وضع الاختبار.
تحجب هذه المنصة مفاتيح vh_live_. استخدم مفتاحًا يبدأ بـ vh_test_ فقط؛ لن يغادر أي طلب بمفتاح حي متصفحك.
يُحفظ المفتاح في متصفحك على docs.videohati.com فقط.
مؤشر غير شفاف أعادته الصفحة السابقة في `nextCursor`.
يرشّح النتائج حسب حالة التسليم.
يرشّح النتائج حسب نوع الحدث الخارجي.
https://api.staging.videohati.com/v1/projects/{projectId}/webhook-endpoints/{id}/deliveries