الوسائط

/v1/media

استخدم العقدة media لتحميل الوسائط أو استردادها أو حذفها.

عناصر الربط

ترتبط عناصر الربط التالية بهذه العقدة:

قبل البدء

عند إرسال رسالة وسائط، يتم تخزين الوسائط على خوادم واتساب لمدة 14 يومًا. إذا قدّم أحد المستخدمين طلبًا لتنزيل الوسائط بعد مرور 14 يومًا، فستطلب خوادم واتساب ملف الوسائط نفسه من العميل داخل المواقع في واتساب للأعمال. وإذا تمت إزالة الوسائط، فسيتم إعلام المستخدم بعدم توفر الوسائط.

لا يمثل افتراض أن الوسائط قد تم تنزيلها ببساطة استنادًا إلى إيصالات التسليم والقراءة أمرًا آمنًا. وتكون الوسائط الصادرة آمنة في العموم لإزالتها خلال آخر 30 يومًا، ولكن يجب عليك استخدام إستراتيجية تناسب نشاطك التجاري بشكل أفضل.

القيود

• إذا كنت تستخدم عملية تحميل الوسائط بدلاً من الربط بعنوان URL للوسائط، فيجب تحميل الملف إلى وحدة تخزين الوسائط. وبمجرد الانتهاء من التحميل، يمكنك إرسال رسالة باستخدام معرف الوسائط.
• يعالج التطبيق الوسائط التي يتم تحميلها قبل إرسالها إلى الخادم. وعلى الرغم من أن الحد الأقصى لحجم ملف الوسائط الذي يمكن تحميله إلى العقدة media هو 100 ميجابايت، يتم فرض تقييدات على مرحلة ما بعد المعالجة لمختلف أنواع الوسائط المحددة في جدول حجم الوسائط بعد المعالجة الموضح أدناه.
• تحتاج عملية تخزين الوسائط إلى أن تتم معالجتها بواسطة النشاط التجاري. وفي حالة امتلاء وحدة تخزين الوسائط، ستفشل عملية إرسال الرسائل.
• لا يتوفر دعم لما يلي:

  • إرسال الوسائط من خلال تدفقات البايت.
  • إرسال الرسائل بملصقات متحركة.

التحميل

أرسل طلب POST إلى /v1/media لتحميل الوسائط الخاصة بك. يجب أن يحتوي نص طلب داخل المواقع على بيانات الوسائط الثنائية ويجب تعيين عنوان Content-Type إلى نوع الوسائط الذي يتم تحميله. وللحصول على الخيارات المدعومة، يمكنك الرجوع إلى القسم أنواع المحتويات المدعومة.

تُعد عملية إرسال البيانات الثنائية في طلب POST HTTP بمثابة طريقة قياسية لتحميل البيانات الثنائية. وإذا كنت تريد تحميل صورة على سبيل المثال، يمكنك إصدار طلب POST مع وحدات بايت الصورة الفعلية في حمولة البيانات. وبدلًا من ذلك، يمكنك استخدام --data-binary إذا كنت تريد cURL لقراءة الملف المتوفر بتنسيق البيانات الثنائية واستخدامه تمامًا كما هو.

مثال

تحميل الوسائط:

POST /v1/media
Content-Type: image/jpeg or other appropriate media type

your-binary-media-data

تحميل الوسائط باستخدام cURL:

curl -X POST \
https://your-webapp-hostname:your-webapp-port/v1/media \
-H 'Authorization: Bearer your-auth-token' \ 
-H 'Content-Type: image/jpeg'  \ # or other appropriate media type
--data-binary @your-file-path

في الحالتين، تؤدي الاستجابة الناجحة إلى إرجاع الحقل id الذي تحتاج إليه لاسترداد الوسائط أو إرسال رسائل وسائط إلى عملائك.

{
    "media": [
        {
            "id": "f043afd0-f0ae-4b9c-ab3d-696fb4c8cd68"
        }
    ]
}

إذا تلقيت رسالة خطأ، يمكنك الرجوع إلى رسائل الخطأ والحالة لمزيد من المعلومات.

أنواع المحتويات المدعومة

حجم الوسائط بعد المعالجة

هذا هو الحد الأقصى للحجم المسموح به لملف الوسائط بعد الضغط والتشفير.

الأسئلة المتكررة

docker volume inspect whatsappMedia

[
    {
        "Driver": "local",
        "Labels": {},
        "Mountpoint": "/var/lib/docker/volumes/whatsappMedia/_data",
        "Name": "whatsappMedia",
        "Options": {},
        "Scope": "local"
    }
]

ls /var/lib/docker/volumes/whatsappMedia/_data/

معرفة المزيد

• أفضل الممارسات
• الرسائل
• المرجع