Ressource média
La ressource de média représente un média, tel qu'une image, associé à un message.
Twilio crée une ressource média et stocke le contenu du média lorsque les événements suivants se produisent :
- Vous envoyez un message avec une image via Twilio
- Vous recevez un média sur l'un de vos numéros de téléphone Twilio
Twilio conserve ce média jusqu'à ce que vous émettiez une requête HTTP DELETE sur cette instance.
Pour sécuriser l'accès aux médias stockés sur Twilio, vous pouvez activer l'authentification HTTP de base dans les paramètres Programmable Messaging de la console.
Les messages envoyés via Twilio peuvent inclure jusqu'à 10 fichiers multimédias d'une taille totale de 5 Mo. Si nécessaire, Twilio redimensionnera les images pour une livraison réussie en fonction des spécifications de l'opérateur. Les messages contenant plus de 5 Mo de médias ne seront pas acceptés.
Propriétés du média
| Resource Properties in REST API format | |
|---|---|
account_sid
|
SID du Compte qui a créé cette ressource de média. |
content_type
|
Valeur par défaut mime‐type du média, par exemple |
date_created
|
Date et heure de création de cette ressource, en GMT, spécifiées au format RFC 2822. |
date_updated
|
Date et heure de la dernière mise à jour de cette ressource, en GMT, spécifiées au format RFC 2822. |
parent_sid
|
SID de la ressource qui a créé le média. |
sid
|
Chaîne unique créée pour identifier cette ressource de média. |
uri
|
URI de cette ressource relatif à |
Extraire une ressource média
https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Messages/{MessageSid}/Media/{Sid}.json
Renvoie une ressource média unique à l'aide de l'une des représentations suivantes :
Par défaut : content‐type
Sans extension, le média est renvoyé à l'aide du type MIME fourni lors de la génération du média.
GET /2010-04-01/Accounts/AC.../Message/MM.../Media/ME557ce644e5ab84fa21cc21112e22c485
Alternative : XML
L'ajout de « .xml » à l'URI renvoie une représentation XML familière. Par exemple :
GET /2010-04-01/Accounts/AC.../Message/MM.../Media/ME557ce644e5ab84fa21cc21112e22c485.xml
<TwilioResponse>
<Media>
<Sid>ME557ce644e5ab84fa21cc21112e22c485</Sid>
<AccountSid>ACda6f1e11047ebd6fe7a55f120be3a900</AccountSid>
<ParentSid>MM8dfedb55c129dd4d6bd1f59af9d11080</ParentSid>
<ContentType>image/jpeg</ContentType>
<DateCreated>Fri, 17 Jul 2009 01:52:49 +0000</DateCreated>
<DateUpdated>Fri, 17 Jul 2009 01:52:49 +0000</DateUpdated>
<Uri>/2010-04-01/Accounts/ACda6f1e11047ebd6fe7a55f120be3a900/Message/MM8dfedb55c129dd4d6bd1f59af9d11080/Media/ME557ce644e5ab84fa21cc21112e22c485.xml</Uri>
</Media>
</TwilioResponse>Alternative : JSON
L'ajout de « .json » à l'URI renvoie une représentation JSON familière. Par exemple :
GET /2010-04-01/Accounts/AC.../Message/MM.../Media/ME557ce644e5ab84fa21cc21112e22c485.json
{
"sid": "ME557ce644e5ab84fa21cc21112e22c485",
"account_sid": "ACda6f1e11047ebd6fe7a55f120be3a900",
"parent_sid": "MM8ff928b2451c0db925bd2d581f0fba79",
"content_type": "image/jpeg",
"date_created": "Fri, 26 Apr 2013 05:41:35 +0000",
"date_updated": "Fri, 26 Apr 2013 05:41:35 +0000",
"uri": "/2010-04-01/Accounts/ACda6f1e11047ebd6fe7a55f120be3a900/Message/MM8dfedb55c129dd4d6bd1f59af9d11080/Media/ME557ce644e5ab84fa21cc21112e22c485.json"
}Parameters
| Parameters in REST API format | |
|---|---|
account_sid
Path
|
SID du Compte qui a créé la ou les ressources de média à extraire. |
message_sid
Path
|
SID de la ressource de message à laquelle appartient cette ressource de média. |
sid
Path
|
Chaîne fournie par Twilio qui identifie de manière unique la ressource de média à extraire |
Comme les URL de médias stockées sont utiles pour de nombreuses applications externes, elles sont publiques et ne nécessitent pas l'authentification HTTP de base pour y accéder. Cela vous permet d'intégrer l'URL dans une application Web sans révéler vos informations d'identification de l'API Twilio.
Si vous avez besoin de restreindre l'accès aux médias stockés avec Twilio, vous pouvez activer l'authentification HTTP dans les paramètres de la console. Lorsque vous récupérez votre média pour le message après avoir activé l'authentification HTTP, vous êtes dirigé vers une URL signée qui n'est valide que pendant 4 heures.
Vous pouvez à tout moment effectuer des requêtes d'API ultérieures pour de nouvelles URL de courte durée pour votre média.
Example 1
Lire plusieurs ressources média
https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Messages/{MessageSid}/Media.json
Renvoie une liste des médias associés à votre compte. La liste inclut des informations de pagination.
Filtrer par date de création
Vous pouvez limiter la liste des médias de messages aux médias créés à une date donnée. Fournissez le paramètre de chaîne de requête suivant à votre appel API :
Parameters
| Parameters in REST API format | |
|---|---|
account_sid
Path
|
SID du Compte qui a créé la ou les ressources de média à lire. |
message_sid
Path
|
SID de la ressource de message à laquelle appartient cette ressource de média. |
date_created
Optional
|
Incluez uniquement les médias créés à cette date. Spécifiez une date au format « AAAA-MM-JJ » en GMT, par exemple : « 2009-07-06 », pour lire le média créé à cette date. Vous pouvez également spécifier une inégalité, telle que « StartTime<=AAAA-MM-JJ », pour lire les médias créés à cette date ou avant minuit, et « StartTime>=AAAA-MM-JJ » pour lire les médias créés à cette date ou après minuit. |
Example 1
Supprimer une ressource média
https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Messages/{MessageSid}/Media/{Sid}.json
Supprime un média de votre compte.
En cas de succès, renvoie HTTP 204 (aucun contenu) sans corps.
Parameters
| Parameters in REST API format | |
|---|---|
account_sid
Path
|
SID du Compte qui a créé la ou les ressources de média à supprimer. |
message_sid
Path
|
SID de la ressource de message à laquelle appartient cette ressource de média. |
sid
Path
|
Chaîne fournie par Twilio qui identifie de manière unique la ressource de média à supprimer |
Example 1
Conseils et applications avancées
- Twilio tente de mettre en cache le fichier multimédia la première fois qu'il est utilisé. Cela peut entraîner un léger retard dans l'envoi du message.
- Twilio met les fichiers en cache lorsque les en‐têtes HTTP le permettent (via les en‐têtes ETag et Last‐Modified). En répondant par
Cache‐Control: no‐cache, Twilio vérifie toujours si le fichier a été modifié, ce qui permet à votre serveur Web de répondre avec une nouvelle version ou avec un 304 Non modifié pour demander à Twilio d'utiliser sa version mise en cache.
Besoin d'aide ?
Ça arrive à tout le monde, il est parfois difficile de coder. Obtenez de l'aide dès maintenant auprès de notre équipe d'assistance, ou appuyez‑vous sur la sagesse collective en visitant le collectif Stack Overflow Twilio ou en parcourant le tag Twilio sur Stack Overflow.
