Présentation de la version Bêta de la spécification OpenAPI de Twilio

Temps de lecture: 2 minutes

April 19, 2021

Rédigé par

Gareth Paul Jones

Twilion

Révisé par

Shawn Stern

Contributeur

Diane Phan

Twilion

Jon Davis

Twilion

Présentation de la version Bêta de la spécification OpenAPI de Twilio

Que vous développiez votre premier produit avec Twilio ou que vous cherchiez à étendre votre offre de produits, vous avez besoin d'un accès facile aux outils dans les langages de programmation ou les environnements que vous utilisez. Aujourd'hui, nous avons le plaisir de vous annoncer que nous proposons en open source une spécification OpenAPI en version bêta pour chaque API Twilio.

Depuis longtemps, nous prenons en charge et maintenons les librairies et outils d'aide dans quelques langages et environnements parmi les plus populaires utilisés par les développeurs. Nous élargissons désormais cette couverture en fournissant une documentation des API Twilio conformément à la spécification OpenAPI, un format standard du secteur pour les API. Cela vous permet de générer automatiquement du code en toute simplicité, pour construire facilement avec Twilio, quels que soient le langage ou les outils que vous utilisez.

Quelles sont vos possibilités avec OpenAPI ?

Générer la librairie client

Grâce à la puissance de la spécification OpenAPI de Twilio et du générateur OpenAPI open source, vous pouvez désormais générer de nouvelles librairies client. Il est ainsi beaucoup plus pratique et plus simple d'utiliser Twilio dans votre langage de programmation préféré, sans écrire des méthodes et des fonctions complexes. Par exemple, il est désormais possible de créer par programmation une librairie Rust fortement typée pour les méthodes API de Twilio.

use dotenv;
use std::env;
use openapi::apis::{configuration::Configuration, default_api as twilio_api};

#[tokio::main]
async fn main() {
  dotenv::dotenv().expect("Failed to read .env file");
  let account_sid = env::var("TWILIO_ACCOUNT_SID").expect("Failed to parse Account SID");
  let api_key = env::var("TWILIO_API_KEY").expect("Failed to parse API Key");
  let api_key_secret = env::var("TWILIO_API_KEY_SECRET").expect("Failed to parse API Key Secret"); 

  let mut twilio_config = Configuration::default();
  // Supply Basic Auth credentials.
  twilio_config.basic_auth = Some((api_key, Some(api_key_secret)));

  let balance = twilio_api::fetch_balance(&twilio_config, &account_sid)
    .await
    .unwrap();

  println!("{:?}", balance);
}

Pour en savoir plus sur la génération de librairies, consultez notre projet de générateur OpenAPI sur GitHub ou les documents sur la génération de librairies.

Simulation de test

Grâce à la spécification OpenAPI, vous pouvez désormais simuler l'API de Twilio pour émuler localement des appels API réels, ce qui accélère et renforce l'intégration de la suite de tests à Twilio.

Par exemple, vous pouvez désormais facilement créer une simulation de serveur de l'API portable de Twilio avec Docker.

docker run --init -d -p 4010:4010 stoplight/prism:4 mock -h 0.0.0.0 https://raw.githubusercontent.com/twilio/twilio-oai/main/spec/json/twilio_api_v2010.json

Pour en savoir plus sur les simulations de test, consultez notre documentation.

Compatibilité avec Postman

Nous avons également ajouté la compatibilité avec Postman, un outil de développement gratuit et simple permettant de passer des appels API avec diverses fonctionnalités utiles. Au lieu de faire référence à la doc Twilio et de créer votre propre collection, vous pouvez vous rendre sur la page de la Collection Postman de Twilio où vous trouverez les collections gérées par l'équipe Twilio. Vous pouvez également parcourir les API Postman de Twilio visuellement depuis cette page.

Consultez nos documents pour en savoir plus sur l'utilisation des Collections Postman de Twilio.

Faites un essai !

Nous avons hâte de voir toutes vos incroyables futures créations avec la spécification OpenAPI de Twilio !

Si vous souhaitez faire part de vos commentaires à notre équipe et en savoir plus sur les fonctionnalités à venir, demandez à rejoindre notre nouveau programme Twilio Insiders ou contactez-moi par e-mail à l'adresse gjones[at]twilio.com.

Articles associés

Ressources connexes

Twilio Docs

Des API aux SDK en passant par les exemples d'applications

Documentation de référence sur l'API, SDK, bibliothèques d'assistance, démarrages rapides et didacticiels pour votre langage et votre plateforme.

Centre de ressources

Les derniers ebooks, rapports de l'industrie et webinaires

Apprenez des experts en engagement client pour améliorer votre propre communication.

Ahoy

Le hub de la communauté des développeurs de Twilio

Meilleures pratiques, exemples de code et inspiration pour créer des expériences de communication et d'engagement numérique.