الانتقال إلى المحتوى الرئيسي
POST
إرسال فيديو

التفويضات

Authorization
string
header
مطلوب

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

الترويسات

X-Device-Id
string

معرف الجهاز لدعم الأجهزة المتعددة. مطلوب عند تسجيل أجهزة متعددة. إذا تم تسجيل جهاز واحد فقط، فسيتم استخدامه كجهاز افتراضي. يمكن أيضا توفيره كعامل استعلام device_id.

مثال:

"my-device-id"

الجسم

multipart/form-data

الحقول الاختيارية التي تجمل الرسالة بدلا من إرسالها الآن. تعيين scheduled_at إلى الجدول الزمني؛ بدونها يتم إرسال الرسالة فوراً. عامل خلفية يرسلها في الوقت المقرر، إعادة المحاولة بينما الجهاز غير متصل أو غير مسجل الدخول. يتم تخزين الوسائط التي تم تحميلها على خادم حتى ينتهي الجدول. في محتوى طلبات multipart/form-data، أرسل weekdays كحقل متكرر (weekdays=1، weekdays=3).

scheduled_at
string<date-time>

RFC3339 وقت الإرسال الأول. يجب أن يكون في المستقبل. يحدث الإرسال الأول دائمًا في هذا الموعد، حتى إذا وقع خارج weekdays أو day_of_month؛ فهذان الحقلان يحددان مرات التكرار التالية.

مثال:

"2026-10-01T09:00:00+07:00"

timezone
string

المنطقة الزمنية للوكالة الدولية للطاقة المستخدمة لحساب العمليات المتكررة مطلوب عند تعيين الـ scheduled_at

مثال:

"Asia/Jakarta"

recurrence
enum<string>
افتراضي:once

كم مرة تكرر إرسال

الخيارات المتاحة:
once,
daily,
weekly,
monthly
weekdays
integer[]

أيام الإرسال ، 0=الأحد خلال 6=يوم السبت. مطلوب عندما يكون التكرار أسبوعيا.

النطاق المطلوب: 0 <= x <= 6
مثال:
day_of_month
integer

يوم من الشهر الذي سيتم إرساله، ضغطت إلى اليوم الأخير من الشهر. مطلوب عندما يكون التكرار شهرياً.

النطاق المطلوب: 1 <= x <= 31
مثال:

15

end_at
string<date-time>

التكرار فقط. لا يرسل بعد هذا الوقت؛ يجب أن يكون بعد الموعد المحدد.

مثال:

"2026-12-31T23:59:59+07:00"

occurrence_limit
integer

التكرار فقط. توقف بعد هذا العديد من الإرسالات.

النطاق المطلوب: x >= 1
مثال:

10

phone
string

رقم الهاتف مع رمز البلد

مثال:

"6289685028129@s.whatsapp.net"

caption
string

التعليق المراد إرساله

مثال:

"ini contoh caption video"

mentions
string[]

قائمة أرقام الهواتف المراد ذكرها (يذكر الشبح - لا @ مطلوبة في الشرح). ويشار أيضاً إلى @phone في الشرح. استخدم الكلمة المفتاحية الخاصة "@everyone" لذكر جميع المشاركين في المجموعة. أرسل حقل نموذج mentions واحدًا لكل إدخال.

مثال:
reply_message_id
string

معرف الرسالة الذي تريد الرد عليه

مثال:

"3EB089B9D6ADD58153C561"

view_once
boolean

عرض مرة واحدة

مثال:

false

video
file

فيديو لإرساله

video_url
string

رابط الفيديو لإرساله

مثال:

"https://example.com/sample.mp4"

compress
boolean

ضغط الفيديو

مثال:

false

hd
boolean

إرسال تسليم فيديو HH264 8-bit YUV 4:2:0 عالية الدقة في نموذج الإبلاغ الموحد 23، على أن يكون الحد الأقصى هو 1280x1280 مع الحفاظ على نسبة العرض وتجنب الارتقاء بالمستوى. تجاوز الضغط عندما يكون صحيحاً.

مثال:

true

gif_playback
boolean

عرض الفيديو كGIF (التكرار، الصامت، التشريح التلقائي)

مثال:

false

duration
integer

اختفاء مدة الرسالة في ثواني. القيم المسموح بها: صفر (بدون انتهاء الصلاحية)، 400 86400 (24 ساعة)، 604800 (7 د)، 000 776 (90 د).

مثال:

86400

is_forwarded
boolean

ما إذا كانت هذه رسالة معاد توجيهها

مثال:

false

allow_reshare
boolean

إظهار زر إعادة المشاركة لمشاهدي الحالة. يشترط أن تكون قيمة phone هي status@broadcast؛ ويرفض GOWA هذا الحقل لأي مستلِم آخر.

مثال:

false

الاستجابة

حسناً

code
string
مثال:

"SUCCESS"

message
string
مثال:

"Success"

results
object