Solución de problemas
La API devuelve un error
401, 403, 404, 429 y 500: qué comprobar en cada caso.
401#
unauthorized: no llega la clave. Revisa la cabeceraAuthorization: Bearer <clave>(con espacio después de «Bearer»).invalid_key: la clave está mal copiada o revocada. Crea otra. Lee Cómo crear, guardar, rotar y revocar una clave de API.
403#
plan_required: la API es de Brand y Agency. Con Pro, la clave solo sirve para MCP.plan: esa ruta usa una función que tu plan no incluye.
404#
not_measured: aún no hay medición. Mide primero.not_found: la ruta o el id no existen.cliente_no_encontrado: el id de cliente no es de tu cartera.
429#
rate_limited: espera los segundos deretryAfter. Lee Límites de la API (rate limits) y cuotas.quotaolimite_diario: tope diario; espera a mañana.
500#
Reintenta pasados unos segundos. Si se repite, escríbenos con la hora, la ruta y la respuesta (sin la clave).
Tabla completa en Errores de la API y cómo resolverlos.
Actualizado el
¿Te ha resultado útil este artículo?
Gracias por tu respuesta.
Artículos relacionados
⌨️ APIErrores de la API y cómo resolverlosCada código de error, qué significa y qué hacer.⌨️ 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.