https://a.storyblok.com/f/270183/39349/916cd028b3/blog_postman_1200x600.png

Apresentamos a coleção de APIs da Vonage no Postman

Publicado em May 11, 2021

Tempo de leitura: 2 minutos

Na Vonage, publicamos especificações OpenAPI para todas as nossas APIs. Essas especificações permitem que nossa comunidade de desenvolvedores explore, avalie e integre as APIs da Vonage de maneira eficiente.

Como Lorna mencionou em seu artigo sobre avaliação de APIs usando o OpenAPI, baixar uma especificação OpenAPI e explorá-la no Postman é uma ótima maneira de se familiarizar com novas APIs.

Não poderia concordar mais! Se você ainda não conhece o Postman, trata-se de uma interface gráfica intuitiva para um poderoso cliente HTTP multiplataforma que recomendo que você experimente.

Temos o prazer de anunciar que agora ficou ainda mais rápido e fácil explorar as APIs da Vonage! Adicionamos um botão “Executar no Postman” à página do Postman em nosso portal de desenvolvedores, então agora você está a apenas alguns cliques de fazer sua primeira solicitação.

Também pode ser encontrado na rede principal do Postman , caso você prefira acessá-la por lá.

Depois de clicar no Executar no Postman , você será direcionado para a instância do Postman de sua escolha, e todas as chamadas da API da Vonage estarão à sua disposição, bem organizadas em uma coleção.

Vonage APIs Postman collection imported view

Uma grande vantagem de usar uma coleção do Postman é que podemos preparar as solicitações para você, de modo que o trabalho necessário para fazer as chamadas à API é mínimo.

Ele também possui alguns recursos interessantes, como a possibilidade de configurar variáveis de ambiente. Essa coleção vem com um Ambiente Vonage que lista API_KEY, API_SECRETe JWT, que são os parâmetros mais comumente usados, mas fique à vontade para adicionar outros à medida que for avançando. Você pode encontrar os ambientes clicando no ícone de engrenagem no canto superior direito.

Vonage environment variables in Postman Collection

Para adicionar suas credenciais, atualize os valores atuais de API_KEY e API_SECRET pela chave e pelo segredo da API encontrados no seu painel da Vonage (não é necessário configurar o JWT por enquanto).

Utilizando a coleção do Postman para as APIs da Vonage

A seguir, vamos examinar mais de perto como usar a coleção do Postman das APIs da Vonage para explorar a API do Numbers.

Expanda a pasta da coleção e localize o Numbers dentro dela.

Numbers requests in Vonage APIs Postman collection

A API de Numbers da Vonage permite que você gerencie seu inventário de números virtuais por meio de programação. Para saber mais sobre as operações disponíveis, não deixe de consultar a Referência da API de Numbers.

Para este exemplo, vamos testar os entrada “Listar os números que você possui” .

Seu api_key e api_secret serão obtidos dinamicamente do ambiente da Vonage; portanto, verifique se você definiu esses valores no ambiente e, em seguida, clique em “Enviar”.

Numbers API List numbers you own response body

E pronto! Você fez com sucesso sua primeira solicitação à API da Vonage usando nossa coleção do Postman!

Experimente, divirta-se e conte para a gente o que achou!

E agora, para onde vamos?

Compartilhar:

https://a.storyblok.com/f/270183/372x373/36054b72d0/julia-biro.png
Julia BiroRepresentante de Desenvolvedores

Julia está empenhada em capacitar outros desenvolvedores por meio da criação de tutoriais, guias e recursos práticos. Com experiência em divulgação e educação, ela busca tornar a tecnologia mais acessível e aprimorar a experiência geral dos desenvolvedores. É comum encontrá-la em eventos da comunidade local.