Validar PIN de usuario de restaurante
GET /api/restaurant/correct_pin_check/{waiter_user_id}/{restaurant_pin}
Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).
⚠️ Este endpoint usa GET por compatibilidad; próximamente tendrá una versión POST.
Verifica que el PIN de restaurante corresponda al usuario activo indicado (cambio rápido de usuario en un equipo compartido).
Quién puede usarlo: cualquier usuario autenticado (administrador o vendedor).
Formato de respuesta: heredado {success, message?, data?} sin paginación. Ante reglas de negocio puede responder HTTP 200 con success: false: revisa siempre success. success: true y data con el usuario si el PIN es correcto; success: false y data: [] si no.
Parámetros de la URL:
| Campo | Tipo | Obligatorio | Descripción / valores permitidos |
|---|---|---|---|
id |
integer | Sí | Id del usuario. |
pin |
string | Sí | PIN de restaurante del usuario. |
Reglas:
- El PIN viaja en la URL: no lo registres en logs de tu integración.
Parámetros
| Parámetro | Dónde | Obligatorio | Ejemplo | Descripción |
|---|---|---|---|---|
waiter_user_id |
ruta | sí | 2 |
|
restaurant_pin |
ruta | sí | 1234 |
Respuestas
200 — PIN correcto
{
"success": true,
"message": "Verificar pin",
"data": {
"id": 7,
"name": "CARLOS RAMOS",
"email": "carlos@empresa.com"
}
}
200 — PIN incorrecto
{
"success": false,
"message": "Verificar pin",
"data": []
}
Pruébalo
Prueba este endpoint con tu empresa y tu token: elige la URL en Servers, pega el token en Authorize y haz clic en Try it out.