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 o solo permite lectura | Pro (lectura), 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.