Saltar al contenido principal

Verificación de Token

Verificacion de token

1. Redirección a la URL de Callback​

Cuando un usuario completa la fila, será redirigido a una URL de callback que ustedes han proporcionado en el backend. Nosotros pasaremos un parámetro llamado token a través de parametro URL (GET).

Ejemplo:​

https://tu-sitio.com/callback?token=76dcad75-257e-4134-a6bd-8fb7ba305fd4

2. Captura del Token y Llamada a Nuestra API​

Una vez que capturen el token de su lado, deben llamar a nuestra API para verificarlo. El endpoint de la API es el siguiente:

/api/v1/queue/verify?token={token_enviado_por_nosotros}

Ejemplo de la llamada a la API:

https://app.virtual-queue.com/api/v1/queue/verify?token=76dcad75-257e-4134-a6bd-8fb7ba305fd4

3. Respuesta de la API​

Si el token es válido y la persona realmente completó la fila, recibirán una respuesta como esta:

{
    "data": {
        "token": "423e6840-0b88-4583-97df-d1bdbbf6c929",
        "finished_line": {
            "finished_at": "2026-05-26T16:30:28Z",
            "ingressed_at": "2026-05-26T16:30:18Z"
        }
    },
    "message": "Token succesfully verified",
    "success": true
}

Explicación de los campos:​

  • ingressed_at: Fecha y hora en la que la persona ingresó a la fila (excluyendo cualquier sala de espera).
  • finished_at: Fecha y hora en la que la persona finalizó la fila y fue redirigida.

Nota: Después de una llamada exitosa, el registro será marcado como verificado para evitar el uso compartido de enlaces y tokens.

Si el token es inválido o ya fue utilizado, recibirán la siguiente respuesta:

{
    "message": "Invalid queue ID",
    "success": false,
    "error_code": "400"
}

4. Ejemplo de Llamada con curl​

A continuación, un ejemplo de cómo hacer la llamada a la API utilizando curl:

curl -X GET "https://app.virtual-queue.com/api/v1/queue/verify?token=76dcad75-257e-4134-a6bd-8fb7ba305fd4" -H "Content-Type: application/json"