الانتقال إلى المحتوى الرئيسي
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"

الجسم

application/json

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

phone
string
مطلوب

رقم هاتف WhatsApp لإرسال الاستطلاع ، بما في ذلك لاحقة '@s.whatsapp.net'.

مثال:

"6289685024421@s.whatsapp.net"

question
string
مطلوب

السؤال المطروح على الاستطلاع.

مثال:

"Siapa Nama Avatar The Last Air Bender?"

options
string[]
مطلوب

خيارات الاستطلاع.

مثال:
max_answer
integer
مطلوب

الحد الأقصى لعدد الإجابات المسموح بها للاقتراع.

مثال:

2

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

duration
integer

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

مثال:

86400

الاستجابة

حسناً

code
string
مثال:

"SUCCESS"

message
string
مثال:

"Success"

results
object