Errores

La API usa códigos HTTP para indicar éxito o error. El detalle se informa en el cuerpo de la respuesta.

Códigos comunes

Código	Descripción
200	Respuesta exitosa.
400	La solicitud tiene un error. Revisar el cuerpo de la respuesta.
401	No autenticado o token expirado.
500	Error no controlado.

Error de request inválido

{
  "tipo": "invalid_request",
  "tipo_codigo": 400,
  "detalle": "Los campos username y password no pueden estar vacíos."
}

Error con detalle por parámetro

{
  "tipo": "invalid_request",
  "tipo_codigo": 400,
  "detalle": {
    "parametro": "refresh_token_expire_time",
    "errores": [
      "Debe ser igual o mayor a 10 minutos."
    ]
  }
}

Errores de autenticación

• 401 suele indicar token expirado, inválido o ausente.
• Si el token pertenece a otro ambiente, la solicitud también va a fallar.
• Verificá Authorization y X-Emisor antes de asumir un problema funcional del endpoint.