Manejo de errores

La API usa códigos de estado HTTP estándar. Un código 2xx indica éxito; 4xx, un problema con la petición; 5xx, un error del servidor.

Códigos de estado

Formato de los errores

Las respuestas de error son un objeto JSON con success en false, un mensaje descriptivo en error y un identificador legible en code.

{
  "success": false,
  "error": "Token missing required scopes: products:write",
  "code": "FORBIDDEN"
}

Errores de validación

Cuando un POST o PUT falla por validación, la API responde 400 con code VALIDATION_ERROR e incluye además un array errors con el detalle por campo.

{
  "success": false,
  "error": "Validation failed",
  "code": "VALIDATION_ERROR",
  "errors": [
    {
      "field": "name",
      "message": "This field is required",
      "code": "required",
      "value": null
    }
  ]
}

Cómo manejarlos

• 400: revisá el cuerpo de la petición y los mensajes de validación que devuelve la API.
• 401: verificá que estás enviando el token y que sigue activo; si fue revocado o expiró, generá uno nuevo.
• 403: confirmá que la cuenta tiene plan Premium y que el token incluye el scope necesario para ese endpoint.
• 404: revisá la URL y el ID del recurso.
• 429: esperá y reintentá con backoff exponencial (ver la sección Límites de uso).
• 5xx: reintentá más tarde; si persiste, consultá el estado del servicio en status.yo-facturo.com.