الـwebhooks في قسم فيديو الأفاتار: إشعار على خادمك عندما يصبح الفيديو جاهزاً
الـwebhooks في قسم فيديو الأفاتار وسيلة لمعرفة أن الفيديو جاهز دون تحديث الصفحة يدوياً: بمجرد انتهاء الرندر يُرسَل طلب POST إلى عنوان خادمك، وخادمك يقرر ما يفعل بعدها — يحفظ الرابط في قاعدة البيانات أو يسلّم الملف للعميل أو يبدأ الخطوة التالية. التبويب مفيد لمن ينتج الفيديوهات دفعات أو يدمج توليد الأفاتار في منتجه: بدل فحص «جاهز أم لا» بلا توقف، يصل إشعار واحد قصير في اللحظة المناسبة تماماً.
لماذا تحتاج هذا فعلاً
رندر الفيديو ليس عملية لحظية، وانتظاره في تبويب مفتوح بلا معنى. بحسب قياسات المنصة بتاريخ 07.09.2026 يُرندَر مقطع Kling 3.0 مدته خمس ثوانٍ بدقة 1080p خلال 115 ثانية في المتوسط، وفي 95% من الحالات خلال 165 ثانية. والمهمة نفسها على Sora 2 تستغرق نحو 145 ثانية في المتوسط. وإذا فحصت الحالة كل بضع ثوانٍ فسوف تتراكم عشرات الطلبات الفارغة لكل مقطع؛ أما الـwebhook فيصل مرة واحدة — عندما يصبح النتيجة موجودة فعلاً.
الحجم يقول الأمر نفسه. بحسب سجل التوليد في المنصة خلال 30 يوماً (3 سبتمبر – 2 أكتوبر 2026) بدأت 3,292 مهمة فيديو، أكملت منها 2,369 بنجاح. تُحسب المقاطع في الخلفية وتنتهي في أوقات مختلفة — لا يمكن تتبّعها يدوياً، بينما يقوم معالج الإشعارات بذلك عنك.
ماذا يمنحك تبويب الـwebhooks
كل شيء هنا عن تسليم الإشعارات، بلا سحر. تسجّل عنواناً، وتختار الأحداث التي تريد الاشتراك بها، وتحصل على سر التوقيع. وقائمة نقاط النهاية المسجلة موجودة في المكان نفسه: يظهر العنوان والأحداث المختارة والحالة وما إذا كان للطرف سر. ويمكنك تدوير السر (فيتوقف القديم فوراً) أو حذف نقطة النهاية كلياً.
يصل الحدث مقابل فيديوهاتك أنت فقط: لن يُرسَل رندر شخص آخر إلى الخارج حتى لو اكتمل في اللحظة نفسها. وهناك أيضاً سجل الأحداث المسلّمة — مفيد للتأكد من أن شيئاً ما وصل فعلاً إلى خادمك.
كيف تبدأ خطوة بخطوة
- افتح قسم فيديو الأفاتار ولوحة الـwebhooks على العنوان المباشر /ar/avatars?tab=webhooks.
- سجّل الدخول: الإعداد غير متاح للزائر — تظهر نافذة الدخول عند النقر.
- في حقل «عنوان نقطة النهاية» أدخل عنوان HTTPS عاماً لخادمك، مثلاً https://example.com/avatar-webhook. لا ينفع HTTP — فالتسليم والتوقيع يعتمدان على قناة مشفّرة.
- حدّد الأحداث المطلوبة. وإذا لم تختر شيئاً فسيكون الاشتراك بكل الأحداث مباشرة.
- اضغط «إضافة نقطة نهاية». يظهر سر التوقيع فور الإنشاء — انسخه واحفظه عندك: فلن يظهر مرة أخرى.
- إذا لم يكن لديك خادم بعد، اضغط «استخدام مستقبلنا» — فستتراكم الإشعارات في سجل الأحداث المسلّمة داخل التبويب.
كيف تتأكد أن الطلب منّا وليس تزويراً
يُرفَق بكل طلب ترويسة signature — وهو HMAC-SHA256 محسوب من الجسم الخام للطلب بمفتاح سرك. احسب التوقيع ذاته على جهتك وقارن: إن لم يتطابق فارفض الطلب. مستقبلنا يفعل هذا تماماً ويردّ 401 على التوقيع الخاطئ. واحفظ السر على الخادم في متغيّرات البيئة، لا في كود العميل.
ماذا يصل في الطلب
الجسم JSON عادي يحمل نوع الحدث وبيانات الكيان. مثلاً، للفيديو الجاهز يكون الحدث avatar_video.success ومعه معرّف المقطع. أما القائمة الكاملة لأنواع الأحداث المتاحة فتُعرض في التبويب: يمكنك تصفّحها وإبقاء ما يحتاجه خدمتك فقط.
كم يكلّف
تسجيل نقطة النهاية وتدوير السر وحذفها وقراءة سجل الأحداث لا تستهلك رموزاً — فهذا إعداد إشعارات وليس توليداً. تُستهلك الرموز على الفيديو نفسه فقط: سعره بالرموز يُعرض قبل التشغيل، وإذا فشلت المهمة يُعاد المبلغ المخصوم. ولا يوجد اشتراك: يحصل المستخدمون الجدد على رموز ابتدائية لأولى التجارب.
يتماشى مع
- المهام المجمّعة — تشغيل عشرات المقاطع بمهمة واحدة؛ ويغني الـwebhook عن فحص الجهوزية يدوياً.
- مكتبة الوسائط — تخزين الملفات المصدرية والجاهزة.
- ترجمة الفيديو و تقطيع المقاطع — الخطوات التالية بعد التوليد.
أسئلة شائعة
ما العنوان المناسب للـwebhook؟
عنوان HTTPS عام فقط. لا تُقبل العناوين المحلية ولا HTTP: يجب أن يسير الإشعار عبر قناة آمنة، وأن يكون خادمك متاحاً من الخارج.
هل يمكنني استلام إشعارات دون خادم خاص بي؟
نعم. اضغط «استخدام مستقبلنا» — فتتراكم الأحداث في سجل «الأحداث المسلّمة» داخل التبويب، ويمكنك مراجعتها دون خادم خلفي خاص.
ماذا أفعل إن لم يتطابق التوقيع؟
تأكد أنك تحسب HMAC-SHA256 من الجسم الخام للطلب (لا من JSON بعد تحليله)، وأنك تستخدم السر الحالي: بعد التدوير يتوقف القديم فوراً.
هل هذا مدفوع؟
إعداد الـwebhooks لا يستهلك رموزاً. تُستهلك الرموز في توليد الفيديو فقط — وسعره يُعرض قبل التشغيل؛ لا يوجد اشتراك، ويحصل المستخدمون الجدد على رموز ابتدائية.