POST/api/v2/templates/media
رفع وسائط هيدر القالب
ارفع صورة أو فيديو أو مستنداً لهيدر واتساب. أرجع assetId إلى headerAssetId. لواتساب الرسمي يمكن إرسال mediaUrl بدل الملف. لواتساب ويب ضع targetProvider=user_session.
طلب HTTP
POST /api/v2/templates/media
ترويسات الطلب
| الترويسة | النوع | الوصف |
|---|---|---|
| X-API-Key | string | مفتاح Rasel API. أرسله في كل طلب موثّق ما عدا الويب هوك الوارد. * |
جسم الطلب
| الحقل | النوع | الوصف | مثال |
|---|---|---|---|
| mediaType | image | video | document | نوع وسائط الهيدر: image أو video أو document. * | |
| file | string (binary) | الملف المرفوع. مرادف headerMedia في إنشاء أو إرسال multipart. | |
| mediaUrl | string | رابط HTTP(S) عام لهيدر الوسائط عند عدم إرفاق ملف. واتساب الرسمي فقط في مسار الرفع. | |
| targetProvider | user_session | eshaar | meta | هدف الرفع: user_session أو eshaar أو meta. |
حقول الاستجابة
| الحقل | النوع | الوصف | مثال |
|---|---|---|---|
| success | boolean | صحيح عندما ينجح الإجراء، أو عندما ينجح مستلم واحد على الأقل في الدفعة. | true |
| data | object | الحمولة الأساسية لمسارات القائمة واللقطة. | |
| message | string | رسالة نتيجة مقروءة بعد الإنشاء أو الرفع. |
رموز الحالة
| الحالة | الوصف |
|---|---|
| 201 | تم الإنشاء. |
| 400 | طلب غير صالح، أو خطأ تحقق، أو المورد لا يمكن استخدامه في هذه الحالة. |
| 401 | مفتاح API مفقود أو غير صالح. |
| 403 | الهاتف غير موثّق، أو الصلاحية ناقصة، أو الحساب لا يستطيع تنفيذ هذا الإجراء. |
| 429 | تم تجاوز حد المعدل، أو وصل عدد محاولات التحقق إلى الحد الأقصى. |
جرّب الطلب
هذا المسار يقبل رفع ملف (multipart/form-data). أرسله من خادمك أو من أداة تدعم الملفات — جرّب الطلب ينفّذ طلبات JSON فقط.