Referencia
Errores de la API y cómo resolverlos
Cada código de error, qué significa y qué hacer.
Los errores llegan en JSON con un código (error) y una explicación (mensaje).
| HTTP | error | Qué significa | Qué hacer |
|---|---|---|---|
| 400 | parametro_invalido | Un parámetro no es válido (el campo va en campo) | Corrígelo |
| 400 | cursor_invalido | El cursor no es de esta ruta | Empieza sin cursor |
| 400 | csv_no_disponible | Esa ruta no tiene lista para CSV | Pide JSON |
| 400 | cliente_no_disponible | Esa ruta no tiene datos por cliente | Usa una ruta de cliente |
| 400 | empty | El envío está vacío | Revisa el cuerpo |
| 401 | unauthorized | Falta la clave | Añade Authorization: Bearer |
| 401 | invalid_key | Clave no válida o revocada | Crea otra |
| 403 | plan_required | Tu plan no incluye la API | Brand o Agency |
| 403 | plan | Tu plan no incluye esa función | Consulta tu plan |
| 404 | not_found | No existe ese recurso | Revisa la ruta o el id |
| 404 | not_measured | Aún no hay medición | Mide primero |
| 404 | cliente_no_encontrado | El cliente no es de tu cartera | Revisa el id |
| 404 | desactivada | Esa función está desactivada | Escríbenos |
| 413 | too_many | Demasiados eventos en un envío | Divide el envío |
| 429 | rate_limited | Límite de peticiones | Espera retryAfter |
| 429 | quota | Tope diario de la cuenta | Espera a mañana |
| 429 | limite_diario | Tope diario de esa ruta | Espera a mañana |
| 500 | internal | Error nuestro | Reintenta; si sigue, escríbenos |
Paso a paso en La API devuelve un error.
Actualizado el
¿Te ha resultado útil este artículo?
Gracias por tu respuesta.
Artículos relacionados
🧯 Solución de problemasLa API devuelve un error401, 403, 404, 429 y 500: qué comprobar en cada caso.⌨️ APIAutenticación de la APICabecera Authorization: Bearer, alternativa X-API-Key y por qué no usar ?key=.⌨️ APILímites de la API (rate limits) y cuotasPeticiones por minuto y por día por clave, cabeceras X-RateLimit y qué hacer ante un 429.
¿No encontraste la respuesta?
Escríbenos y te respondemos. Si tienes cuenta, usa «Contáctanos» en el panel: nos llega con el contexto de tu cuenta.