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 |
|---|---|
400 | Lote sin ningún producto válido (lista no vacía, pero ningún SKU resuelve a un producto vivo). |
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. |
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). |
503 | Servicio en pausa (mantenimiento, IA apagada o API pública deshabilitada): no se cobró. |