Skip to content

Códigos de Error

Códigos de Error

Tabla de códigos

CódigoSignificadoCausa común
400Bad RequestDatos inválidos, password débil, parámetros incorrectos
401UnauthorizedToken faltante, inválido o expirado
403ForbiddenNo tienes permiso para esta acción
404Not FoundRecurso no encontrado
409ConflictDuplicado (correo, código, etc.)
422Unprocessable EntityError de validación de schema
426Upgrade RequiredDebe cambiar la contraseña antes de continuar
429Too Many RequestsLímite de rate excedido
500Internal Server ErrorError inesperado del servidor

Ejemplos de respuestas

400 — Bad Request

{
"detail": "Password débil. Debe tener mínimo 8 caracteres, una mayúscula, un número y un carácter especial."
}

401 — Unauthorized

{
"detail": "Credenciales inválidas"
}

403 — Forbidden

{
"detail": "No tienes permiso para esta acción"
}

404 — Not Found

{
"detail": "Producto no encontrado"
}

409 — Conflict

{
"detail": "El correo juan@example.com ya está registrado"
}

422 — Validation Error

{
"detail": [
{
"loc": ["body", "nombre"],
"msg": "field required",
"type": "value_error.missing"
}
]
}

426 — Upgrade Required

{
"detail": "Debe cambiar su contraseña antes de continuar"
}

429 — Too Many Requests

{
"detail": "Límite de solicitudes excedido. Intenta de nuevo en 60 segundos."
}

500 — Internal Server Error

{
"detail": "Error interno del servidor"
}