Saltar al contenido
Facturador

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.