Respuestas y errores

Respuestas correctas

Código	Significado
`200`	La petición salió bien. El cuerpo trae el resultado.
`201`	Se creó lo que pediste. El cuerpo trae lo creado.

Errores

Cuando algo sale mal, el código HTTP indica el tipo de problema y el cuerpo trae un mensaje que explica qué pasó:

{ "error": "Inicia sesión para continuar" }

Si el problema está en uno o varios campos que enviaste, la respuesta también trae Fields, con el mensaje de cada campo:

{
  "error": "Email: El correo no es válido",
  "Fields": {
    "Email": "El correo no es válido",
    "Password": "Mínimo 8 caracteres"
  }
}

Códigos de error

Código	Cuándo ocurre
`400`	Algún dato no es válido. Revisa `Fields`.
`401`	Falta el token, venció, o no es del tipo que pide la ruta (por ejemplo, un token de cliente en una ruta de la tienda).
`402`	El banco rechazó el pago de una compra. Ver Comprar.
`404`	Lo que buscas no existe, o es de otra tienda o de otro cliente.
`409`	La petición choca con el estado actual (un correo ya registrado, no hay unidades suficientes).
`429`	Demasiados registros de clientes en la última hora. Espera y reintenta.
`502`	Un servicio interno respondió con un error. Reintenta en un momento.
`503`	Un servicio no está disponible ahora. Reintenta en unos segundos.

Reintentos

Los errores 502 y 503 suelen ser pasajeros. Reintenta con una espera creciente (1 s, 2 s, 4 s). No reintentes los 4xx: repetir la misma petición dará el mismo error. La excepción es crear una compra: mira Comprar antes de repetirla.