Verify

A API Vonage Verify permite enviar um PIN para o celular de um usuário e confirmar se ele o recebeu. Ela pode ser utilizada em diversos cenários de autenticação e combate à fraude, incluindo:

  • Autenticação de dois fatores (2FA)
  • Login sem senha
  • Validação do número de telefone

O Painel oferece um ambiente de teste integrado para você experimentar a API Verify imediatamente — sem precisar escrever código.

Verify a user

A versão Verify V2 já está disponível. A versão Verify V2 inclui novos canais (WhatsApp, e-mail, autenticação silenciosa) e callbacks mais abrangentes. Consulte o Verify a documentação da API V2 para começar. Observe que Verify se a versão V1 está sendo descontinuada — se você estiver na versão V1, consulte o Verify V1 to V2 Migration Guide.

Experimente com uma interface de usuário

O Painel permite que você envie um PIN de verificação válido para o seu número de telefone cadastrado diretamente do navegador. Uma verificação bem-sucedida consome o crédito da sua Account.

  1. Faça login no Painel da API da Vonage
  2. Acesse Construir > Verify na barra lateral esquerda
  3. Sob Enviar PIN, preencha os seguintes campos:
Campo Descrição
O nome da sua marca O nome exibido ao usuário quando ele recebe o PIN (por exemplo, Vonage)
Número de telefone cadastrado The phone number of your verified account — the test environment only sends messages to the registered number
Comprimento do PIN Escolha de 4 dígitos ou de 6 dígitos
  1. Clique Enviar PIN
  2. Digite o PIN que você recebeu no seu celular para concluir a verificação

Quer definir seu próprio PIN? Consulte Verificar a documentação da solicitação para mais detalhes.

Experimente com código

O Painel oferece trechos de código prontos para uso, que permitem fazer solicitações diretamente à API do Verify. Esses exemplos utilizam Autenticação básica por uma questão de simplicidade. Para uso em produção, recomendamos utilizar Autenticação JWT.

Selecione seu idioma nas abas: cURL, Nó, .Net, Java, PHP, Python, ou Ruby.

Fazer uma solicitação de verificação

Envia um PIN para o número de telefone especificado. Uma solicitação bem-sucedida retorna um request_id — salve isso para confirmar ou cancelar a solicitação.

Verifique a solicitação com um código

Valida o PIN digitado pelo usuário. Insira seu request_id da etapa anterior, juntamente com o código PIN recebido no aparelho.

Cancelar a solicitação

Cancela uma solicitação de verificação em andamento usando o request_id retornado no momento em que a solicitação foi feita.

Você pode encontrar sua chave e seu segredo da API em Configurações da API.

Leitura complementar