Compartilhar:
){kind=small}
Álvaro é um ex-membro da equipe da Vonage. Ele atuou como defensor dos desenvolvedores na Vonage, com foco em APIs de rede. É apaixonado por experiência do desenvolvedor, APIs e código aberto. Fora do trabalho, é comum encontrá-lo explorando lojas de quadrinhos, participando de festivais de ficção científica e terror ou montando coisas com aqueles famosos blocinhos de plástico.
Apresentamos o Vonage Virtual Operator para APIs de rede
Tempo de leitura: 1 minuto
Uma das perguntas mais frequentes que recebemos dos desenvolvedores é: “Como posso testar as APIs de rede se elas não estão disponíveis no meu país?” Não precisa dizer mais nada. Temos o prazer de anunciar a disponibilidade do Operador Virtual.
O Operador Virtual fornece respostas de API predefinidas e determinísticas ao utilizar o Vonage Playground. Ele funciona como uma operadora de celular comum, mas aceita apenas solicitações de API com números de telefone que utilizem o +990 prefixo.
Vamos dar uma olhada em como isso funciona!
Usar o Operador Virtual é muito simples. Basta criar uma aplicação no painel (ou usar uma já existente) e selecionar “Playground” na seção “Recursos da API de Rede”. É só isso. Não é necessária nenhuma configuração adicional. A partir de agora, todas as solicitações de API que utilizarem as credenciais vinculadas a essa aplicação e os números de telefone com o +990 prefixo serão direcionadas para o Operador Virtual.
Quando o aplicativo estiver pronto, acesse o página do Playground para verificar os operadores disponíveis compatíveis com o Playground. A primeira entrada corresponde ao Operador Virtual:
Dashboard Playground Operators list
Observe que não é necessário adicionar +990 números à lista de permissões do seu Playground. Basta fazer uma chamada de API para qualquer uma das APIs de rede compatíveis.
O Operador Virtual fornece respostas determinísticas para solicitações de API utilizando números de telefone que começam com +990. O comportamento é definido pelos parâmetros de entrada na solicitação de API, incluindo diferentes intervalos em alguns parâmetros ou terminações específicas de números de telefone. A documentação contém todas as combinações possíveis de respostas da API para as APIs de rede compatíveis.
Por exemplo, o /check ponto final da API de troca de SIM sempre retornará “true” se o parâmetro maxAge for maior que 500:
curl --url https://api-eu.vonage.com/camara/sim-swap/v040/check \
--header 'Authorization: Bearer $TOKEN' \
--header 'Content-Type: application/json' \
--data '{"phoneNumber": "+990123456", "maxAge": "500"}'
Caso queiramos testar o cenário em que a API retorna um erro, poderíamos enviar uma solicitação à API usando um número de telefone que termine em 99:
curl --url https://api-eu.vonage.com/camara/sim-swap/v040/check \
--header 'Authorization: Bearer $TOKEN' \
--header 'Content-Type: application/json' \
--data '{"phoneNumber": "+990123499, "maxAge": "500"}'Lembre-se de que a autenticação deve ser implementada da mesma forma que em uma operadora de celular comum.
Você já usou o novo Operador Virtual? Adoraríamos receber seus comentários! Junte-se a nós no Slack da Comunidade Vonage ou envie uma mensagem para nós no X, e entraremos em contato com você.
Obrigado pela leitura!
Compartilhar:
Álvaro é um ex-membro da equipe da Vonage. Ele atuou como defensor dos desenvolvedores na Vonage, com foco em APIs de rede. É apaixonado por experiência do desenvolvedor, APIs e código aberto. Fora do trabalho, é comum encontrá-lo explorando lojas de quadrinhos, participando de festivais de ficção científica e terror ou montando coisas com aqueles famosos blocinhos de plástico.