Referencia de la API
Manejo de Errores
Códigos de error estándar, cabeceras de límite de uso y resolución de problemas.
Última actualización:
Manejo de errores
Todas las respuestas de error siguen un formato consistente con un código de error y un mensaje legible por humanos:
{
"error": {
"code": "ERROR_CODE",
"message": "Description of what went wrong"
}
}Códigos de error
| HTTP Status | Code | Description |
|---|---|---|
| 400 | VALIDATION_ERROR | Parámetros de solicitud inválidos o faltantes |
| 401 | UNAUTHORIZED | Clave de API faltante o inválida |
| 402 | PAYMENT_REQUIRED | Créditos insuficientes |
| 403 | FORBIDDEN | El acceso a la API requiere el plan Business, o la acción no está permitida |
| 403 | LIMIT_EXCEEDED | Límites del plan alcanzados (proyectos, compilaciones, etc.) |
| 404 | NOT_FOUND | Recurso no encontrado o no accesible |
| 409 | CONFLICT | Conflicto de recurso (implementación en curso, dominio tomado, etc.) |
| 429 | RATE_LIMITED | Demasiadas solicitudes — verifica los encabezados de límite de tasa |
| 500 | INTERNAL_ERROR | Error del servidor — reintenta o contacta al soporte |
Encabezados de límite de tasa
Cada respuesta incluye estos encabezados:
X-RateLimit-Remaining— Número de solicitudes restantes en la ventana actualX-RateLimit-Reset— Segundos hasta que se restablezca la ventana de límite de tasa
Cuando recibes una respuesta 429, espera el número de segundos indicado por X-RateLimit-Reset antes de reintentar.
Costos en créditos
Acciones de la API que consumen créditos:
| Action | Credits |
|---|---|
| Crear proyecto (compilación inicial) | 5 |
| Refinamiento | 1 |
| Edición de código | 1 |
| Reimplementación | 1 |
| Rollback | 1 |
| Clone | 2 |
| Reactivar | 1 |
| Pregunta al asesor | 1 |
Los administradores están exentos de los cargos de créditos.
Solución de problemas
- 401 Unauthorized — Verifica que tu clave de API comience con
flp_y esté incluida como token Bearer - 403 Forbidden — Verifica que tu cuenta tenga una suscripción Business activa
- 409 Conflict on deploy — Espera a que finalice la implementación actual o cancélala primero
- Subdomain errors — Los subdominios deben estar en minúsculas, tener entre 3 y 63 caracteres, y contener solo letras, números y guiones