Autenticación

Inicio de sesión de usuario

Autentica un usuario registrado y devuelve la información del usuario con token JWT. El usuario debe estar previamente registrado en el sistema.

Caso de uso:

  1. El mesero o administrador del restaurante abre la aplicación Restobar
  2. Ingresa su correo electrónico y contraseña registrados
  3. El sistema valida las credenciales y retorna los datos del usuario
  4. Se obtiene el token JWT (tokenCurrent) que debe incluirse en el header Authorization: Bearer {token} para todas las siguientes solicitudes API
  5. Con este token, el usuario puede acceder a funciones como gestionar productos, tomar pedidos, generar facturas, etc.

Importante: Guarde el valor tokenCurrent de la respuesta para autenticación en futuras solicitudes.

post/login

Request

  • Base URL
    https://api.pirpos.com
  • URL
    https://api.pirpos.com/login
  • Auth
    HTTP bearer

Request body

emailstring email required

Dirección de correo electrónico del usuario

passwordstring password required

Contraseña del usuario

Example request

{
  "email": "usuario@ejemplo.com",
  "password": "password123"
}

Response

Inicio de sesión exitoso. Valor importante: Tome el campo tokenCurrent de esta respuesta y úselo como token de autorización en el header de sus próximas solicitudes API. Ejemplo: Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

_idstring

ID del usuario

namestring

Nombre del usuario

lastNamestring

Apellido del usuario

emailstring email

Correo electrónico del usuario

phonestring

Número de teléfono del usuario

tokenCurrentstring

Token JWT para autenticación

rolestring

ID del rol del usuario

isActiveboolean

Si el usuario está activo

urlImagestring

URL de la imagen de perfil del usuario

lastAccessstring date-time

Marca de tiempo del último acceso

lastTokenDevicestring

Último token del dispositivo

Example response

{
  "_id": "507f1f77bcf86cd799439011",
  "business": {
    "_id": "507f1f77bcf86cd799439012",
    "name": "Restaurante ABC"
  },
  "name": "Juan",
  "lastName": "Pérez",
  "email": "usuario@ejemplo.com",
  "phone": "+57 300 123 4567",
  "tokenCurrent": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "role": "507f1f77bcf86cd799439013",
  "isActive": true,
  "urlImage": "https://ejemplo.com/perfil.jpg",
  "lastAccess": "2025-08-04T10:30:00.000Z",
  "lastTokenDevice": "fcm_token_example"
}

Changes

No recorded changes to this operation across all 1 revision of this API.