Interfaz de Programación/1. Inicialización del Proceso de Verificación
2 min read
1. Inicialización del Proceso de Verificación
Iniciar una nueva sesión de verificación y activar el servidor de conexión.
El sistema ReOTP utiliza la función Wake on Demand para preservar los recursos del servidor. Esto significa que su conexión de WhatsApp está inactiva, y al enviar esta solicitud, el servidor se activa para abrir la conexión y estar listo para recibir el mensaje del cliente.
Parámetros Enviados (Request Body):
apiKey(Texto - Obligatorio): Su clave API del proyecto.
phoneNumber(Texto - Obligatorio): Número de teléfono del usuario (Ejemplo:+966500000000).
method(Texto - Opcional): Método de verificación"WHATSAPP"o"TELEGRAM"(Por defecto:"WHATSAPP").
returnUrl(Texto - Opcional): El enlace al que se redirigirá al cliente después de una verificación exitosa en la aplicación Telegram.
Parámetros Recibidos (Response Body):
requestId(Texto): Identificador único de la operación para seguir el estado de la verificación.
waLink(Texto): Enlace de WhatsApp (se devuelve solo si el método esWHATSAPP).
tgLink(Texto): Enlace de Telegram (se devuelve solo si el método esTELEGRAM).
expectedText(Texto): Texto del mensaje automático que debe enviarse.
expiresIn(Texto): Tiempo de caducidad de la solicitud (dos minutos).
Notas Importantes:
- Duración de la validez: El cliente tiene solo dos minutos (02:00) para abrir el enlace y enviar el mensaje automático desde su teléfono antes de que la sesión expire y el servidor vuelva a su estado de inactividad.
- Interfaz de Usuario: Recomendamos encarecidamente mostrar un contador regresivo (Countdown) al cliente en su interfaz para animarlo a enviar el mensaje rápidamente.
Envíe una solicitud POST a la URL que se muestra en el panel de código lateral para iniciar el proceso.
Integration Code (SDKs)
Interactive Playground
Interactive API Console
Enter phone number to initialize and test server response instantly:
Sandbox de API interactivo (Interactive API Playground)
Prueba el envío directo de solicitudes de verificación y genera códigos de integración en el lenguaje de programación que prefieras.
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"
}'