Monday, 24 May, 2021 UTC


Summary

Esteja você criando seu primeiro produto com a Twilio ou procurando expandir sua oferta de produtos, você precisa de acesso fácil a ferramentas nas linguagens de programação ou ambientes mais usados. Hoje, temos o prazer de anunciar que temos a Especificação da OpenAPI de código aberto em Beta para cada API da Twilio.
Por muito tempo, prestamos suporte e mantivemos bibliotecas de ajuda e ferramentas em várias linguagens e ambientes mais populares usados pelos desenvolvedores. Agora, estamos expandindo essa cobertura fornecendo arquivos de documentação de acordo com a Especificação da OpenAPI, um formato padrão do setor para APIs. Assim fica mais simples gerar o código automaticamente para que você possa desenvolver com a Twilio sem complicações, seja qual for a linguagem ou a ferramenta usada.
O que você pode fazer com o OpenAPI?

Geração da biblioteca do cliente

Com o poder da Especificação OpenAPI da Twilio e do gerador de OpenAPI de código aberto, você pode criar novas bibliotecas de cliente. Assim, fica muito mais prático e simples usar a Twilio na linguagem de programação de sua preferência, sem escrever métodos e funções complexas. Por exemplo, agora é possível criar sistematicamente uma biblioteca Rust fortemente tipada para os métodos de API da 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); } 
Para saber mais sobre a geração de bibliotecas auxiliares, consulte nosso Boilerplate Gerador de Projetos com OpenAPI no GitHub ou os documentos da Twilio sobre geração de biblioteca de auxiliares.

Teste simulado

Com a Especificação do OpenAPI, você agora pode simular a API da Twilio para emular localmente chamadas reais de API, o que torna a integração do conjunto de testes com a Twilio mais rápida e menos frágil.
Por exemplo, agora você pode facilmente criar um servidor de simulação da API da Twilio portátil com o Docker.
# Dockerfile # Choose the base image for us to build from. FROM alpine # Install dependencies. RUN apk update && \ apk add --update git && \ apk add --update npm && \ npm i -g @stoplight/prism-cli # Clone the Twilio OpenAPI spec. RUN git clone https://github.com/twilio/twilio-oai.git # Perform preprocessing on the v2010 spec JSON file. RUN sed -i.bak '/pattern:/d' ./twilio-oai/spec/json/twilio_api_v2010.json && \ sed -i.bak 's/</Before/' ./twilio-oai/spec/json/twilio_api_v2010.json && \ sed -i.bak 's/>/After/' ./twilio-oai/spec/json/twilio_api_v2010.json # Expose the port that Prism runs on. EXPOSE 4010 # Run Prism! CMD ["prism", "mock", "-h", "0.0.0.0", "./twilio-oai/spec/json/twilio_api_v2010.json"] 
Para saber mais sobre testes simulados, consulte nossa documentação.

Suporte do Postman

Também adicionamos suporte para o Postman, que é uma ferramenta de desenvolvimento gratuita e direta para fazer chamadas de API com uma variedade de recursos úteis. Em vez de consultar os documentos da Twilio e criar sua própria coleção, você pode visitar a página de Coleções da Twilio no Postman, onde encontrará coleções mantidas pela equipe da Twilio. Você também pode navegar visualmente pelas usando o Postman.
Acesse nossa documentação para saber mais sobre o uso das Coleções Postman da Twilio.
Experimente!
Estamos ansiosos para ver todas as coisas incríveis que você criará com a Especificação da OpenAPI da Twilio! 🚀
Este artigo foi traduzido do original "Introducing Twilio’s OpenAPI Specification Beta". Enquanto melhoramos nossos processos de tradução, adoraríamos receber seus comentários em [email protected] - contribuições valiosas podem render brindes da Twilio.