موفرو خدمات الوسائط

/v1/settings/application/media/providers

استخدم نقطة النهاية /v1/settings/application/media/providers لتجميع قائمة موفري خدمات الوسائط من أجل إرسال روابط الوسائط. وتتيح لك قائمة موفري خدمات الوسائط أن يكون لديك موفرو خدمات وسائط مختلفون لنوع موفر الخدمات نفسه مع إمكانية اختيار موفر خدمات لاستخدامه حسب الطلب.

الاسترداد

استخدم طلب واجهة API هذا لاسترداد قائمة موفري الخدمات.

المثال

GET /v1/settings/application/media/providers

تتضمن الاستجابة الناجحة قائمة موفري الخدمات:

"settings": {
        "application": {
            "media": {
                "providers": [ 
                    {
                        "name": "your-first-provider",
                        "type": "www",
                        "config": {
                            "basic": {
                                "username": "your-username",
                                "password": "your-password"
                            }
                        }
                    },
                    {
                        "name": "your-second-provider",
                        "type": "www",
                        "config": {
                            "bearer": "your-bearer-token"
                        }
                    }
                ]
            }
        }
    }

تتضمن الاستجابة غير الناجحة رسالة خطأ. ولمزيد من المعلومات حول الأخطاء، يمكنك الرجوع إلى الرموز البرمجية الخاصة بالخطأ والحالة.

التحديث

لتكوين موفري الخدمات لعميل واجهة API الخاصة بتطبيق WhatsApp للأعمال، استخدم نقطة النهاية /v1/settings/application/media/providers مع تضمين معلومات موفر الخدمة. ولا يمكنك حاليًا إعداد أكثر من موفر خدمات واحد في الوقت نفسه. ولا يمكنك سوى استخدام كائنات موفر الخدمات هذه من أجل إرسال رسائل الوسائط باستخدام روابط HTTP/HTTPS تعتمد على المصادقة الأساسية أو مصادقة الرمز المميز bearer.

المثال

توضح الأمثلة التالية إضافة موفر خدمات WWW (روابط HTTP/HTTPS) بالتصريح الأساسي وموفر خدمات بمصادقة الرمز المميز bearer. هذه هي تنسيقات موفر الخدمات المدعومة حاليًا فقط.

POST /v1/settings/application/media/providers
[{
    "name": "your-first-provider",
    "type": "www",
    "config": {
        "basic": {
            "username": "your-username",
            "password": "your-password"
        }
    }
 }
]

POST /v1/settings/application/media/providers
[{
    "name": "your-second-provider",
    "type": "www",
    "config": {
        "bearer": "your-bearer-token"
    }
 }
]

يقوم الطلب الناجح بإرجاع الرمز لحالة HTTP وهو 200 OK، وnull أو {}.

تتضمن الاستجابة غير الناجحة رسالة خطأ. لمزيد من المعلومات حول الأخطاء، يمكنك الرجوع إلى رموز الخطأ والحالة.

المعلمات

الحذف

سيؤدي إرسال استدعاء واجهة API DELETE متضمنًا name التابع لموفر الخدمة إلى نقطة النهاية /v1/settings/application/media/providers إلى حذف موفر الخدمة هذا من قائمتك.

المثال

DELETE /v1/settings/application/media/providers/your-config-name

يقوم الطلب الناجح بإرجاع الرمز لحالة HTTP وهو 200 OK، وnull أو {}.

تتضمن الاستجابة غير الناجحة رسالة خطأ. لمزيد من المعلومات حول الأخطاء، يمكنك الرجوع إلى رموز الخطأ والحالة.