Problemas frecuentes
Resuelve los problemas más habituales con CaptureKit.
La mayoría de los tickets de soporte se reducen a un puñado de causas. Repasa primero esta página: suele resolver el problema más rápido que esperar una respuesta.
| Síntoma | Causa más probable | Solución |
|---|---|---|
Todas las llamadas devuelven 401 | Nombre de cabecera incorrecto o un espacio copiado con el secreto | La cabecera es x-api-key. Vuelve a copiar el secreto o crea una clave nueva. |
401 Rate limit exceeded | Una cuota por clave o el límite de tasa de tu plan | Reparte el tráfico, sube los límites de la clave o mejora el plan. |
Las llamadas devuelven de repente 402 | Saldo agotado o una factura impagada | Compra una recarga, activa la recarga automática o paga la factura. |
| Tiempos de espera agotados justo a los 10 s o 30 s | Tu plataforma corta antes de que respondamos | Sube el tiempo de espera de tu función o de tu cliente a 60 segundos. |
400 en una petición que antes funcionaba | Falta un parámetro obligatorio o está mal escrito | Compáralo con la página del endpoint en la Referencia de la API. |
| Los créditos bajan más rápido de lo previsto | Reintentos o un bucle llamando al mismo endpoint | Busca llamadas idénticas repetidas en los registros de peticiones. |
| Falta el saldo o las claves en el panel | Espacio de trabajo incorrecto seleccionado | Usa el selector de la parte superior de la barra lateral. |
| El playground gasta créditos sin esperarlo | Las llamadas del playground son llamadas reales a la API | Usa el endpoint de consumo gratuito para probar la autenticación, o el Simulador para estimar el coste sin tráfico. |
402 con créditos que aún se muestran | Una factura impagada bloquea la cuenta | Abre Configuración → Facturas, paga la factura y vuelve a intentarlo. |
Una lista de 60 segundos
Lee el código de estado
401 → clave o límite de tasa. 402 → saldo o factura. 400 → parámetros. 5xx → reintenta con backoff.
Encuentra la fila en Registros API
Haz coincidir la marca de tiempo. Abre el panel de detalle para ver los parámetros exactos y el mensaje de error.
Comprueba el saldo de la barra lateral
Si está cerca de cero, recarga o activa la recarga automática antes de reintentar una carga de producción.
Sigues bloqueado
Abre un ticket de soporte desde Configuración → Soporte → Nuevo ticket. Indica el endpoint, la marca de tiempo y el código de estado que has visto: con esos tres datos encontramos la petición en segundos. API Status, en el mismo menú, te dice si el problema es cosa nuestra.