Referencia de la API

NeXusOS expone una API REST abierta (v2). Esta página describe la autenticación, los endpoints básicos y ejemplos.

Autenticación

La API utiliza tokens Bearer. Crea un token en el panel de administración en Usuarios → Tokens de API y envíalo en la cabecera en cada petición:

Authorization: Bearer YOUR_TOKEN_HERE

URL base

Todos los endpoints están bajo:

https://your-installation.example.com/api/v2

Endpoints principales

Método	Ruta	Descripción
GET	/users	Lista de todos los usuarios
POST	/users	Crear un nuevo usuario
GET	/users/{id}	Obtener un usuario
PATCH	/users/{id}	Actualizar un usuario
DELETE	/users/{id}	Eliminar un usuario
GET	/audit-logs	Obtener logs de auditoría

Ejemplo de petición

curl -X GET https://your-installation.example.com/api/v2/users \
  -H "Authorization: Bearer YOUR_TOKEN_HERE" \
  -H "Accept: application/json"

Limitación de peticiones

La API está limitada a 100 peticiones por minuto y token. Si se supera, recibirás un estado 429 Too Many Requests.