Códigos de error
La API usa códigos HTTP estándar. Estos son los que puede devolver la superficie pública.
| Código | Significado |
|---|---|
401 | API key ausente, malformada, inválida, revocada o expirada. |
402 | Saldo de créditos insuficiente. |
403 | La llave no tiene el scope requerido. |
404 | Recurso no encontrado (o de otro tenant: no se distingue). |
409 | Conflicto: el SKU ya existe · lote no cancelable · operación con esa Idempotency-Key en vuelo. |
413 | El cuerpo excede el límite de 2 MB (import de catálogo y subida de imágenes). |
422 | Payload inválido (incl. lote vacío o con más de 500 productos) · Idempotency-Key reusada con otro payload o endpoint. |
428 | Falta el Idempotency-Key obligatorio (POST /v1/batches). |
429 | Límite de tasa (reintenta tras Retry-After) o tope de gasto diario de IA (sin Retry-After). |
502 | El proveedor de imágenes rechazó la solicitud (sesiones de fotos con IA): no se cobró. Revisa las referencias y reintenta. |
503 | Servicio en pausa (mantenimiento, IA apagada o API pública deshabilitada): no se cobró. |