Códigos de Error

Comprensión de las respuestas de error de la API

Formato de Respuesta de Error

Todas las respuestas de error siguen este formato:

{
  "success": false,
  "error": {
    "code": "error_code",
    "message": "Human-readable error message"
  }
}

Códigos de Error

400Bad Request

Los parámetros de la solicitud son inválidos o están mal formados.

Solución: Verifica el cuerpo de tu solicitud y asegúrate de que todos los campos obligatorios estén presentes con valores válidos.

401Unauthorized

Clave de API inválida o faltante.

Solución: Asegúrate de incluir una clave API válida en el encabezado de Autorización.

402Payment Required

No hay suficientes créditos en tu cartera de API.

Solución: Compra más créditos o espera a que se recarguen tus créditos.

403Forbidden

Acceso a la API no aprobado o su cuenta está suspendida.

Solución: Contacta con soporte si crees que esto es un error.

404Not Found

El recurso solicitado (tarea, webhook, etc.) no fue encontrado.

Solución: Verifica que el ID del recurso sea correcto.

429Too Many Requests

Demasiadas solicitudes en un período breve.

Solución: Implementa retroceso exponencial y respeta los límites de frecuencia.

500Internal Server Error

Algo salió mal en nuestro sistema.

Solución: Reintenta la solicitud después de un breve retraso. Si el problema persiste, contacta con soporte.

Límites de Tasa

Límites de frecuencia predeterminados: