Guía de Inicio Rápido

Esta guía te lleva desde cero a tu primera llamada API exitosa en menos de 5 minutos.

Obtener credenciales
Registra un nuevo tenant mediante el endpoint de registro:

curl -X POST https://api.neopos.app/api/auth/register-tenant \
  -H "Content-Type: application/json" \
  -d '{
    "tenant": {
      "codigo": "MIEMPRESA",
      "nombre": "Mi Empresa SAS",
      "nit": "900123456-7",
      "plan": "BASICO",
      "limite_usuarios": 3
    },
    "admin_nombre": "Admin Principal",
    "admin_correo": "admin@miempresa.com",
    "admin_password": "AdminPass1!"
  }'

Iniciar sesión
Guarda el access_token y refresh_token de la respuesta:

curl -X POST https://api.neopos.app/api/auth/login \
  -H "Content-Type: application/json" \
  -d '{"correo": "admin@miempresa.com", "password": "AdminPass1!"}'

{
  "access_token": "eyJ...",
  "refresh_token": "a1b2c3d4...",
  "expires_in": 3600,
  "usuario": { "nombre": "Admin Principal", "rol": 1 }
}

Crear un producto
Usa el access_token en el header Authorization:

curl -X POST https://api.neopos.app/api/productos/ \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer eyJ..." \
  -d '{"codigo": "PROD001", "nombre": "Café Latte", "precio": 5000, "stock": 100}'

Consultar productos

curl https://api.neopos.app/api/productos/ \
  -H "Authorization: Bearer eyJ..."

Refrescar el token (cuando expire)

curl -X POST https://api.neopos.app/api/auth/refresh \
  -H "Content-Type: application/json" \
  -d '{"refresh_token": "a1b2c3d4..."}'

Manejo de errores

Código	Significado	Qué hacer
`400`	Bad Request	Revisa que los datos enviados sean válidos
`401`	Unauthorized	El token expiró — haz refresh
`403`	Forbidden	No tienes permiso para esta acción
`404`	Not Found	Verifica el ID del recurso
`409`	Conflict	El recurso ya existe (correo duplicado, etc.)
`403`	Forbidden con `code: "PASSWORD_CHANGE_REQUIRED"`	Debes cambiar tu contraseña antes de continuar
`429`	Too Many Requests	Espera antes de hacer más llamadas
`500`	Internal Server Error	Error del servidor — reporta al equipo

Guía de Inicio Rápido

Guía de Inicio Rápido

Manejo de errores

Siguientes pasos