Fournisseurs de contenus multimédias
/v1/settings/application/media/providers
Utilisez le point de terminaison /v1/settings/application/media/providers pour compiler une liste de fournisseurs de contenus multimédias pour l’envoi de liens multimédias. Cette liste vous permet de disposer de fournisseurs différents pour le même type de fournisseur, tout en ayant la possibilité d’en choisir un quand vous le souhaitez.
Récupération
Utilisez cette requête d’API pour récupérer la liste de fournisseurs.
Exemple
GET /v1/settings/application/media/providers
En cas de réussite, la réponse renvoyée comprend la liste des fournisseurs :
"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"
}
}
]
}
}
}
En cas d’échec, la réponse renvoyée contient un message d’erreur. Pour plus d’informations sur les erreurs, consultez l’article Codes d’erreur et d’état.
Mise à jour
Pour configurer les fournisseurs du client de l’API WhatsApp Business, utilisez le point de terminaison /v1/settings/application/media/providers avec les informations du fournisseur. Actuellement, vous ne pouvez configurer qu’un fournisseur à la fois. De plus, vous ne pouvez utiliser ces objets fournisseurs que pour envoyer des messages multimédias à l’aide de liens HTTP/HTTPS qui reposent sur une authentification de base ou une authentification par token de support.
Exemple
Les exemples ci-dessous montrent comment ajouter un fournisseur web (liens HTTP/HTTPS) avec autorisation de base et un fournisseur avec authentification par token de support. Actuellement, ce sont les seuls formats de fournisseurs pris en charge.
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"
}
}
]
En cas de réussite, la réponse renvoyée comprend le code d’état HTTP 200 OK, et null ou {}.
En cas d’échec, la réponse renvoyée contient un message d’erreur. Pour plus d’informations sur les erreurs, consultez l’article Codes d’erreur et d’état.
Assurez-vous de donner un nom unique à chaque fournisseur, car la réutilisation d'un nom écrase l'entrée précédente.
Paramètres
| Nom | Description |
|---|---|
| Obligatoire. Nom du fournisseur |
| Obligatoire. Type de fournisseur |
| Obligatoire. Objet |
Suppression
Envoyez un appel d’API DELETE avec le name d’un fournisseur au point de terminaison /v1/settings/application/media/providers pour supprimer ce fournisseur de votre liste.
Exemple
DELETE /v1/settings/application/media/providers/your-config-name
En cas de réussite, la réponse renvoyée comprend le code d’état HTTP 200 OK, et null ou {}.
En cas d’échec, la réponse renvoyée contient un message d’erreur. Pour plus d’informations sur les erreurs, consultez l’article Codes d’erreur et d’état.