ReOTP.
Interface de Programação/1. Iniciar Processo de Verificação
2 min read

1. Iniciar Processo de Verificação

Inicie uma nova sessão de verificação e ative o servidor de conexão.

O sistema ReOTP utiliza o recurso Wake on Demand para preservar os recursos do servidor. Isso significa que sua conexão WhatsApp está 'dormindo' e, quando você envia esta solicitação, o servidor 'acorda' para abrir a conexão e fica pronto para receber a mensagem do cliente.

Parâmetros de Solicitação (Request Body):

  • apiKey (string - obrigatório): Chave de API do seu projeto.
  • phoneNumber (string - obrigatório): Número de telefone do usuário (Exemplo: +966500000000).
  • method (string - opcional): Método de verificação "WHATSAPP" ou "TELEGRAM" (Padrão: "WHATSAPP").
  • returnUrl (string - opcional): Link para o qual o cliente será redirecionado após a verificação bem-sucedida no aplicativo Telegram.

Parâmetros de Resposta (Response Body):

  • requestId (string): ID único da operação para acompanhar o status da verificação.
  • waLink (string): Link do WhatsApp (retornado apenas se o método for WHATSAPP).
  • tgLink (string): Link do Telegram (retornado apenas se o método for TELEGRAM).
  • expectedText (string): Texto da mensagem automática que deve ser enviada.
  • expiresIn (string): Tempo de expiração da solicitação (2 minutos).

Observações Importantes:

  • Duração da Validade: O cliente tem apenas dois minutos (02:00) para abrir o link e enviar a mensagem automática do seu telefone antes que a sessão expire e o servidor 'durma' novamente.
  • Interface do Usuário: Recomendamos fortemente exibir um contador regressivo (Countdown) para o cliente em sua interface para incentivá-lo a enviar a mensagem rapidamente.

Envie uma solicitação POST para o link mostrado no painel de código lateral para iniciar o processo.

Integration Code (SDKs)
curl -X POST https://[your-domain.com]/api/verify/init \
  -H "Content-Type: application/json" \
  -d '{
    "apiKey": "YOUR_API_KEY",
    "method": "WHATSAPP"
  }'
Interactive Playground
Plataforma Interativa para Teste de API

Digite o número de telefone para inicializar a sessão e testar a resposta do servidor instantaneamente:

API Playground Interativo ao Vivo

Experimente enviar solicitações de verificação diretamente e gere códigos de integração na linguagem de programação de sua preferência.

curl -X POST https://reotp.com/api/verify/init \
  -H "Authorization: Bearer 15a1c1c7-ed05-40df-b7c3-69c327542a07" \
  -H "Content-Type: application/json" \
  -d '{
    "phoneNumber": "201000000000",
    "method": "WHATSAPP"
  }'