Visión General de la API

Introduccion

La API REST de RakuWP permite que el plugin de WordPress se comunique con el servidor del panel. Maneja la validacion de licencias, activacion y desactivacion de sitios, y consultas de servicios. Todos los endpoints de la API estan bajo el prefijo /api/v1/.

Autenticacion

Las solicitudes de la API se autentican usando una clave de licencia enviada en el cuerpo de la solicitud. No se necesitan tokens de API ni flujos OAuth — la clave de licencia misma sirve como credencial de autenticacion.

Endpoints Disponibles

Validacion de Licencia

POST /api/v1/license/validate

Valida una clave de licencia y devuelve los detalles del plan, estado y limites de sitios. Usado por el plugin durante la configuracion inicial.

Activacion de Sitio

POST /api/v1/license/activate

Activa una licencia en una URL de sitio especifica. Registra la version de WordPress, version de PHP y version del plugin del sitio. Devuelve un token de activacion.

Desactivacion de Sitio

POST /api/v1/license/deactivate

Desactiva una licencia de un sitio especifico. Libera un espacio en el limite de sitios.

Verificacion de Licencia

POST /api/v1/license/check

Verificacion periodica desde el plugin. Actualiza la marca de tiempo de la ultima verificacion y reporta las versiones actuales del sitio.

Verificacion de Sitio

POST /api/v1/site/verify

Verifica que un sitio esta correctamente activado y la licencia es valida. Usado para validacion periodica.

Lista de Servicios

GET /api/v1/services

Devuelve la lista de todos los servicios disponibles con sus nombres, descripciones, versiones y categorias.

Formato de Respuesta

Todas las respuestas son JSON. Las respuestas exitosas incluyen un campo success: true. Las respuestas de error incluyen un campo error con un mensaje legible y un codigo de estado HTTP apropiado (400, 401, 403, 404 o 500).