Códigos de estado
Códigos de estado HTTP devueltos por la API de Piloterr y cómo gestionarlos.
La facturación se aplica a las solicitudes exitosas: 200 para llamadas síncronas, 201 para trabajos asíncronos. 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 | No se requiere ninguna acción. |
201 | Sí | Trabajo creado | No se requiere ninguna acción. |
202 | No | Aceptado (asíncrono) | La solicitud fue aceptada y está siendo procesada. Use el ID del trabajo para verificar el estado. |
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. Contáctenos si cree que esto es un error. |
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. |