إرسال حدث تجريبي
إرسال حدث تجريبي
POST
/v1/projects/{projectId}/webhook-endpoints/{id}/send-testتدعم هذه العملية مصادقة ملف ارتباط جلسة لوحة التحكم. استدعها من شيفرة خادم موثوقة فقط، ولا تنشئ المتصفحات ملف الجلسة أو تكشفه.
يضع تسليم video.encoding.ready اصطناعيًا لهذه النقطة فقط في قائمة الانتظار، ويضبط data.__test=true حتى يستطيع المستقبل فصله في الإنتاج. يحتاج مفتاح المشروع إلى write.
رموز الخطأ: unauthorized (401), insufficient_scope (403),
endpoint_not_found (404), webhooks_unconfigured (503).
المصادقة
- apiKey — مفتاح المشروع في ترويسة
Authorization: Bearerبصيغةvh_live_...للوضع الفعلي أوvh_test_...للوضع التجريبي، ويحمل صلاحيةreadو/أوwrite. - sessionCookie — ملف ارتباط جلسة لوحة التحكم الذي يضبطه
POST /v1/auth/login. تتطلب مسارات الفيديو والتشغيل أيضًا معاملprojectIdعند استخدام الجلسة.
المعاملات
| الاسم | الموضع | النوع | إلزامي | الوصف |
|---|---|---|---|---|
projectId | path | string (Ulid) | نعم | — |
id | path | string (Ulid) | نعم | — |
جسم الطلب
اختياري
نوع المحتوى: application/json
الاستجابات
| الرمز | المعنى |
|---|---|
202 | وُضع التسليم الاصطناعي في قائمة الانتظار. |
401 | لم تُقدَّم بيانات اعتماد صالحة. |
403 | بيانات الاعتماد صالحة لكنها لا تسمح بهذا الإجراء. يذكر وصف العملية قيم error.code الدقيقة. |
404 | المورد غير موجود أو غير مرئي لهذا المستدعي. |
429 | تم تجاوز حد المعدّل. |
جرّبها
POST
/v1/projects/{projectId}/webhook-endpoints/{id}/send-testوضع الاختبار فقط
منصة API التفاعلية
أرسل طلبًا حيًا إلى api.videohati.com بمفتاح وضع الاختبار.
تحجب هذه المنصة مفاتيح vh_live_. استخدم مفتاحًا يبدأ بـ vh_test_ فقط؛ لن يغادر أي طلب بمفتاح حي متصفحك.
يُحفظ المفتاح في متصفحك على docs.videohati.com فقط.
https://api.staging.videohati.com/v1/projects/{projectId}/webhook-endpoints/{id}/send-test