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

Menu

Expand
Évaluez cette page :

API REST de Twilio

Les API (Application Programming Interfaces‌ou interfaces de programmation d'applications) de Twilio alimentent sa plateforme de communication. Derrière ces API se trouve une couche logicielle qui connecte et optimise les réseaux de communication du monde entier pour permettre à vos utilisateurs d'appeler et de communiquer avec n'importe qui, dans le monde entier.

Twilio dispose d'une large gamme d'API, des SMS à la voix en passant par le sans-fil. La documentation de référence d'API de Twilio est disponible dans toute la documentation produit. Vous pouvez parcourir les différentes API ici, ou accéder directement à la référence d'API pour Programmable SMS ou Programmable Voice.

Mais en fait, qu'est-ce qu'une API REST ?

API signifie Application Programming Interface (Interface de programmation d'application). Une API est un ensemble de règles qui permettent aux programmes de communiquer entre eux, exposant les données et les fonctionnalités sur Internet dans un format cohérent.

REST signifie Representational State Transfer (Transfert d'état de représentation). Il s'agit d'un modèle architectural qui décrit comment les systèmes distribués peuvent exposer une interface cohérente. Lorsque les gens utilisent le terme « API REST », ils font généralement référence à une API accessible via le protocole HTTP à un ensemble prédéfini d'URL.

Ces URL représentent diverses ressources : toute information ou tout contenu accessible à cet emplacement, qui peut être renvoyé sous forme de fichiers JSON, HTML, audio ou images. Souvent, les ressources ont une ou plusieurs méthodes qui peuvent être exécutées sur elles via HTTP, comme GET, POST, PUT et DELETE. L'action représentée par la première et la dernière de ces méthodes est claire, mais POST et PUT ont des significations spécifiques. La façon dont elles sont définies est complexe, mais la règle générale est la suivante : utilisez POST pour créer des ressources et PUT pour mettre à jour des ressources.

Twilio, par exemple, fournit de nombreuses API REST distinctes pour l'envoi de messages texte, les appels téléphoniques, la recherche de numéros de téléphone, la gestion de vos comptes et bien plus encore. Dans l'écosystème de Twilio, chaque produit est sa propre API, mais vous travaillerez avec chacun d'entre eux de la même manière, que ce soit directement via HTTP ou en utilisant les librairies de Twilio‌pour plusieurs langages de programmation différents.

Travailler avec les API Twilio

S'authentifier avec HTTP

Twilio prend en charge la HTTP Basic authentication (l'authentification HTTP de base). Cela vous permet de protéger les URL de votre serveur Web afin que vous seul et Twilio puissiez y accéder. Pour vous authentifier via HTTP, vous pouvez fournir un nom d'utilisateur et un mot de passe au format d'URL suivant :

https://username:password@api.twilio.com/2010-04-01/your_desired_path

Pour la HTTP Basic authentication, vous utiliserez votre Account SID Twilio comme nom d'utilisateur et votre Auth Token comme mot de passe :

curl -G https://api.twilio.com/2010-04-01/Accounts \
  -u '<YOUR_ACCOUNT_SID>:<YOUR_AUTH_TOKEN>'

Vous trouverez votre Account SID et votre jeton d'authentification dans la console Twilio après avoir créé un compte d'essai gratuit Twilio.

Reveal Your Auth Token

Si vous souhaitez utiliser des clés API pour vous authentifier à la place de vos Account SID et Auth Token Twilio, utilisez la clé API comme nom d'utilisateur et le code secret de votre clé API comme mot de passe :

curl -G https://api.twilio.com/2010-04-01/Accounts \
  -u '<YOUR_API_KEY>:<YOUR_API_KEY_SECRET>'

Le type de clé API doit être créé comme Main pour la commande ci-dessus pour accéder à vos comptes. Les clés de type Standard ne peuvent être utilisées que sur les commandes où vous fournissez également l'Account SID dans le cadre de l'API. Par exemple :

curl -X GET 'https://api.twilio.com/2010-04-01/Accounts/\
  '<YOUR_ACCOUNT_SID>/Applications.json' \
  -u $'<YOUR_API_KEY>:<YOUR_API_KEY_SECRET>'

Twilio s'authentifie auprès de votre serveur Web à l'aide du nom d'utilisateur et du mot de passe fournis et reste connecté pendant toute la durée de l'action.

Pour en savoir plus sur la façon dont Twilio gère l'authentification, consultez notre documentation sur la sécurité.

S'authentifier à l'aide des SDK Twilio

Pour le moment, Twilio propose six librairies officiellement prises en charge côté serveur :

Toutes ces librairies sont fournies avec une classe Utilities qui facilite la validation des demandes : il vous suffit de transmettre vos Account SID et Auth Token (disponibles dans la console) à la librairie.

Vous devez toujours utiliser des variables d'environnement pour garder secrets vos Account SID et Auth Token avant de partager un code ou de le déployer en production. Pour en savoir plus, consultez nos conseils sur la définition des variables d'environnement.

Comment les API Twilio utilisent les webhooks

Les webhooks sont des rappels HTTP définis par l'utilisateur et déclenchés par un événement dans une application Web. Twilio utilise des webhooks pour informer votre application lorsque des événements se produisent, comme recevoir un appel entrant ou recevoir un SMS. Les webhooks sont déclenchés de manière asynchrone.

Lorsque l'événement webhook se produit, Twilio émet une requête HTTP (généralement POST ou GET) sur l'URL que vous avez configurée pour votre webhook. La requête de Twilio à votre application inclut des détails sur l'événement, comme le corps d'un message entrant ou le numéro de téléphone entrant. Votre application peut alors exécuter la logique nécessaire, puis répondre à Twilio avec une réponse contenant les instructions que Twilio devrait effectuer.

Pour gérer un webhook lorsque vous utilisez Twilio, vous devez créer une petite application Web capable d'accepter les requêtes HTTP. Consultez nos librairies officiellement prises en charge pour être rapidement opérationnel.

Explorer les API

Envoyer un SMS avec l'API de Twilio

L'API Twilio Programmable SMS vous permet d'envoyer et de recevoir des SMS. Vous devrez vous inscrire pour obtenir un compte Twilio gratuit pour commencer.

        
        
        
        Ce code crée une nouvelle instance de la ressource Messages et envoie un POST HTTP à l'URI de la ressource Messages.

        Envoyer un SMS simple à l'aide de l'API Programmable SMS

        Ce code crée une nouvelle instance de la ressource Messages et envoie un POST HTTP à l'URI de la ressource Messages.

        Pour obtenir un guide détaillé sur l'envoi et la réception de messages avec Twilio, consultez nos guides de démarrages rapides de Programmable SMS. Il vous suffit de sélectionner le langage de programmation côté serveur de votre choix et de vous plonger dans :

        Découvrez les autres API de Twilio

        Twilio dispose d'un certain nombre d'API REST qui peuvent vous aider à intégrer des communications puissantes dans vos applications, y compris Programmable Voice, Programmable Video, Super SIM et Authy pour l'authentification à double facteur et la connexion sans mot de passe.

        Nous avons hâte de vous voir à l'œuvre !

        É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