معرف الوسائط

/v1/media/{media-id}

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

قبل البدء

قبل استرداد الوسائط المحذوفة، يجب أولاً تحميل الوسائط عبر /v1/media.

الاسترداد

بعد تحميل الوسائط بنجاح، ستستلم استجابة تحتوي على معرف الوسائط. استخدم هذا المعرف في أي طلبات لاسترداد الوسائط المخزنة في عميل API الخاصة بواتساب للأعمال.

يتم استخدام هذه العملية أيضًا للاسترداد عندما يرسل المستخدم صورة لك تم استلامها بواسطة حدث Webhook. عند استلام رسالة تتضمن وسائط، سيقوم عميل API الخاصة بواتساب للأعمال بتنزيل الوسائط. بمجرد تنزيل الوسائط، ستستلم إشعار عبر حدث Webhook؛ استخدم معرف الوسائط المتواجد في هذا الإشعار لاسترداد الوسائط.

يمكنك تمكين عميل API الخاصة بواتساب للأعمال لتنزيل الوسائط تلقائيًا من خلال التنزيل التلقائي لإعدادات الوسائط.

مثال

GET /v1/media/media-id

على سبيل المثال، باستخدام مثال الصورة التي تم تحميلها في القسم السابق:

curl -X GET \
  https://your-webapp-hostname:your-webapp-port/v1/media/4b5bf27b-8672-4d55-bc21-d096dc200d0f \
  -H 'Authorization: Bearer your-auth-token' 

لإرسال مثال الوسائط هذا إلى ملف ما، استخدم المعلمة -o، كما هو موضح أدناه:

curl -X GET \
  https://your-webapp-hostname:your-webapp-port/v1/media/4b5bf27b-8672-4d55-bc21-d096dc200d0f \
  -H 'Authorization: Bearer your-auth-token' \
  -o path/filename

إذا كان الاستدعاء ناجحًا، فستظهر استجابة تحتوي على حالة 200 OK وبيانات الوسائط الثنائية.

Content-Type: image/jpeg or other appropriate media type
Content-Length: content-size

binary-media-data

إذا استخدمت أداة مثل Postman، فستظهر الصورة. إذا كنت تستخدم أداة سطر الأوامر، فستظهر بيانات ثنائية. أما إذا أرسلت البيانات إلى ملف ما، فستظهر الصورة في متصفح الملفات لديك.

إذا لم يتم العثور على الوسائط، فسيتم إرجاع رمز استجابة 404 Not Found بدون نص أساسي.

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

الحذف

لحذف الوسائط في عميل API الخاصة بواتساب للأعمال، أرسل طلب DELETE إلى عقدة media مع تضمين معرف الوسائط التي تريد حذفها. استخدم المعرف الذي حصلت عليه من الاستجابة لتحميل الوسائط أو رسالة الوسائط من حدث Webhook.

مثال

الطلب:

DELETE /v1/media/media-id

تعرض الاستجابة الناجحة 200 OK وnull أو {}. إذا لم يتم العثور على الوسائط، فستعرض الاستجابة 404 Not Found ولن تحتوي على نص أساسي. إذا استلمت رسالة خطأ مختلفة، فيمكنك الرجوع إلى رسائل الخطأ والحالة لمزيد من المعلومات.