Plataforma
Errores
Interpretá los códigos HTTP y los errores de la API.
API v1AnteriorFormato de error
V1 no usa un único envelope para todos los errores. Algunas respuestas incluyen error_code y message; otras devuelven success: false y error. Comprobá primero el estado HTTP y después los campos disponibles.
429 · cuota diaria agotada
{
"error_code": "QUOTA_EXCEEDED",
"message": "Account limit exceeded."
}Códigos conocidos
| HTTP | error_code | Significado |
|---|---|---|
| 401 | INVALID_API_KEY | API key inválida, revocada o faltante |
| 403 | PAID_PLAN_REQUIRED | La opción solicitada requiere un plan pago o Custom |
| 429 | RATE_LIMIT_EXCEEDED | Límite RPM compartido por cuenta y entorno entre V1 y V2 |
| 429 | QUOTA_EXCEEDED | Cupo Basic compartido agotado; details identifica el límite y su reset |
| 429 | QUOTA_EXCEEDED_INTELLIGENT | Cuota diaria intelligent agotada |
| 429 | MONTHLY_QUOTA_EXCEEDED | Cuota mensual agotada |
| 429 | MISS_LIMIT_EXCEEDED | Control legacy de misses para operaciones V1 que aún lo aplican; no rige Basic autenticado |
| 403 | custom_plan_required | El endpoint de módulos requiere un contrato Custom |
| 403 | module_not_enabled | Uno o más módulos no están habilitados en el contrato |
| 409 | idempotency_conflict | La Idempotency-Key ya fue utilizada con otro payload |
| 409 | module_query_in_progress | Ya existe una consulta activa para la patente con otro conjunto de módulos |
Este índice reúne los códigos documentados; cada referencia muestra además sus respuestas específicas. Conservá el cuerpo de error para diagnóstico sin registrar credenciales.
Recuperación
| HTTP | Acción recomendada |
|---|---|
| 400 | Corregí los parámetros o el body antes de repetir. |
| 401 | Revisá la API key y su estado. |
| 403 | Comprobá los permisos del plan o del contrato. |
| 404 | Revisá el ID y el entorno de la consulta. |
| 409 | Respetá la idempotencia y el job activo de esa patente. |
| 429 | Distinguí RPM de cuota agotada y esperá según corresponda. |
| 5xx | Aplicá reintentos acotados para fallas transitorias; preservá la idempotencia. |