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
|
The SID of the Account associated with this Media resource. |
content_type
|
The default MIME type of the media, for example |
date_created
|
The date and time in GMT when this Media resource was created, specified in RFC 2822 format. |
date_updated
|
The date and time in GMT when this Media resource was last updated, specified in RFC 2822 format. |
parent_sid
|
The SID of the Message resource that is associated with this Media resource. |
sid
|
The unique string that identifies this Media resource. |
uri
|
The URI of this Media resource, relative to |
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
|
The SID of the Account associated with the Media resource. |
message_sid
Path
|
The SID of the Message resource that is associated with the Media resource. |
sid
Path
|
The Twilio-provided string that uniquely identifies the Media resource to fetch. |
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
|
The SID of the Account that is associated with the Media resources. |
message_sid
Path
|
The SID of the Message resource that is associated with the Media resources. |
date_created
Optional
|
Only include Media resources that were created on this date. Specify a date as |
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
|
The SID of the Account that is associated with the Media resource. |
message_sid
Path
|
The SID of the Message resource that is associated with the Media resource. |
sid
Path
|
The unique identifier of the to-be-deleted Media resource. |
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.