Códigos de Error
Lista completa de códigos de error de la API, sus significados y cómo manejarlos.
Códigos de Estado HTTP
La API de RakuWP usa códigos de estado HTTP estándar para indicar el resultado de una solicitud:
| Código | Significado | Cuándo Ocurre |
|---|---|---|
200 | Éxito | La solicitud se procesó correctamente |
400 | Solicitud Incorrecta | Parámetros faltantes o inválidos |
401 | No Autorizado | Clave de licencia inválida o faltante |
403 | Prohibido | La licencia está expirada, suspendida o revocada |
404 | No Encontrado | El endpoint o recurso no existe |
429 | Demasiadas Solicitudes | Se excedió el límite de tasa |
500 | Error del Servidor | Error inesperado del servidor |
Formato de Respuesta de Error
Todas las respuestas de error siguen una estructura JSON consistente:
{
"success": false,
"error": "Mensaje de error legible",
"code": "CODIGO_ERROR"
}Códigos de Error Comunes
Errores de Licencia
| Código | Descripción | Resolución |
|---|---|---|
LICENSE_INVALID | La clave de licencia no es reconocida | Verifica errores tipográficos. Copia la clave del panel. |
LICENSE_EXPIRED | La licencia ha expirado | Renueva tu suscripción desde la página de Facturación. |
LICENSE_SUSPENDED | La licencia ha sido suspendida | Contacta con soporte para asistencia. |
SITE_LIMIT_REACHED | Se alcanzó el número máximo de sitios activos | Desactiva un sitio existente antes de añadir uno nuevo. |
SITE_NOT_REGISTERED | La URL del sitio no está registrada | Añade la URL de tu sitio en el panel antes de activar. |
Errores de Solicitud
| Código | Descripción | Resolución |
|---|---|---|
MISSING_PARAMETER | Falta un campo obligatorio | Consulta la documentación de la API para campos requeridos. |
INVALID_URL | La URL proporcionada no es válida | Asegúrate de que la URL del sitio incluye el protocolo (https://). |
RATE_LIMITED | Demasiadas solicitudes en poco tiempo | Espera y reintenta. Implementa retroceso exponencial. |
Manejo de Errores en tu Código
Siempre verifica el campo success en la respuesta antes de procesar datos. Registra las respuestas de error para depuración. El plugin maneja la mayoría de errores automáticamente, pero las integraciones personalizadas deben implementar un manejo de errores adecuado.