Códigos de estado
Códigos de estado HTTP devueltos por la API de Chartquery y cómo gestionarlos.
Las llamadas síncronas se facturan con el 200. Las llamadas asíncronas (is_async=true) devuelven un 202 (no facturado) y se facturan cuando el trabajo termina con éxito — registrado como 201 en sus registros de solicitudes. El sondeo GET /jobs/{job_id} es siempre gratuito. Los trabajos fallidos (500) nunca se facturan. La facturación del 404 varía según el endpoint (consulte la página de cada endpoint). Todas las demás respuestas 4xx/5xx son gratuitas.
| Código | Facturado | Estado | Acción |
|---|---|---|---|
200 | Sí | Llamada API exitosa (síncrona) | No se requiere ninguna acción. |
201 | Sí | Trabajo asíncrono completado | Aparece en sus registros de solicitudes cuando un trabajo asíncrono termina con éxito — es en ese momento cuando se factura. Nunca se devuelve como respuesta HTTP. |
202 | No | Aceptado (asíncrono) | El trabajo fue aceptado y puesto en cola. Consulte GET /jobs/{job_id} para obtener el resultado — el sondeo es siempre gratuito. |
400 | No | Solicitud incorrecta | Verifique sus parámetros y sus tipos. Consulte la documentación para más información. |
401 | No | Clave API inválida | Verifique su clave API (encabezado x-api-key o cadena de consulta x_api_key). |
401 | No | Clave API inactiva | Active su clave API en la sección Claves API de la configuración de su cuenta. |
401 | No | Clave API expirada | Actualice su clave API o genere una nueva. |
401 | No | Rate limit exceeded | Espere y reintente. Mejore su plan o aumente las cuotas por clave si esto ocurre con frecuencia. |
402 | No | Payment required | Recargue créditos, mejore su plan, active la Recarga automática o liquide las facturas pendientes. |
403 | No | Prohibido | Verifique sus permisos. Para API Stats, un HTTP 403 significa que el endpoint no está habilitado en su cuenta: contacte al soporte para activarlo. |
404 | Según el caso | No encontrado | La facturación es específica de cada endpoint. Consulte la página del endpoint correspondiente. |
413 | No | Carga demasiado grande | El archivo subido o el cuerpo de la solicitud supera el límite de tamaño. Consulte la documentación para los tamaños máximos. |
500 | No | Error interno | Reintente la acción o contacte a nuestro equipo de soporte. |