ReOTP.
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 es WHATSAPP).
  • tgLink (Texto): Enlace de Telegram (se devuelve solo si el método es TELEGRAM).
  • 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)
curl -X POST https://[your-domain.com]/api/verify/init \
  -H "Content-Type: application/json" \
  -d '{
    "apiKey": "YOUR_API_KEY",
    "method": "WHATSAPP"
  }'
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"
  }'