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 forWHATSAPP).
tgLink(string): Link do Telegram (retornado apenas se o método forTELEGRAM).
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)
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"
}'