You are viewing the French site, but your language preference is set to English. Switch to English site →

Menu

Expand
Évaluez cette page :

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 :

  1. Vous envoyez un message avec une image via Twilio
  2. 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<AC> Not PII

SID du Compte qui a créé cette ressource de média.

content_type
string Not PII

Valeur par défaut mime‐type du média, par exemple image/jpeg, image/png ou image/gif

date_created
date_time<rfc2822> Not PII

Date et heure de création de cette ressource, en GMT, spécifiées au format RFC 2822.

date_updated
date_time<rfc2822> Not PII

Date et heure de la dernière mise à jour de cette ressource, en GMT, spécifiées au format RFC 2822.

parent_sid
sid<MM> Not PII

SID de la ressource qui a créé le média.

sid
sid<ME> Not PII

Chaîne unique créée pour identifier cette ressource de média.

uri
uri Not PII

URI de cette ressource relatif à https://api.twilio.com.

Extraire une ressource média

get
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
get sid<AC> Not PII

SID du Compte qui a créé la ou les ressources de média à extraire.

message_sid
Path
get sid<MM> Not PII

SID de la ressource de message à laquelle appartient cette ressource de média.

sid
Path
get sid<ME> Not PII

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

        get
        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
        get sid<AC> Not PII

        SID du Compte qui a créé la ou les ressources de média à lire.

        message_sid
        Path
        get sid<MM> Not PII

        SID de la ressource de message à laquelle appartient cette ressource de média.

        date_created
        Optional
        get date_time_inequality<iso8601> Not PII

        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
              
              
              
              Renvoyer la liste des médias associés à votre message

              Lire le média

              Renvoyer la liste des médias associés à votre message

              Supprimer une ressource média

              delete
              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
              delete sid<AC> Not PII

              SID du Compte qui a créé la ou les ressources de média à supprimer.

              message_sid
              Path
              delete sid<MM> Not PII

              SID de la ressource de message à laquelle appartient cette ressource de média.

              sid
              Path
              delete sid<ME> Not PII

              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.
                    Évaluez cette page :

                    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.

                          
                          
                          

                          Merci pour vos commentaires!

                          Veuillez sélectionner la ou les raisons de vos commentaires. Les informations supplémentaires que vous fournissez nous aident à améliorer notre documentation:

                          Envoi de vos commentaires...
                          🎉 Merci pour vos commentaires!
                          Une erreur s'est produite. Veuillez réessayer.

                          Merci pour vos commentaires !

                          Recommandez‑nous et gagnez 10 € en 3 étapes simples!

                          Étape 1

                          Obtenir le lien

                          Obtenez un lien de recommandation personnel gratuit ici

                          Étape 2

                          Donner 10 €

                          Votre utilisateur s'inscrit et effectue la mise à niveau en utilisant le lien

                          Étape 3

                          Gagner 10 €

                          1 250 SMS gratuits
                          OU 1 000 minutes vocales gratuites
                          OU 12 000 chats
                          OU plus