Référence de l API

NeXusOS expose une API REST ouverte (v2). Cette page décrit l authentification, les points de terminaison de base et des exemples.

Authentification

L API utilise des jetons Bearer. Créez un jeton dans le panneau d administration sous Utilisateurs → Jetons API et envoyez-le dans l en-tête à chaque requête :

Authorization: Bearer YOUR_TOKEN_HERE

URL de base

Tous les points de terminaison se trouvent sous :

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

Points de terminaison principaux

Méthode	Chemin	Description
GET	/users	Liste de tous les utilisateurs
POST	/users	Créer un nouvel utilisateur
GET	/users/{id}	Récupérer un utilisateur
PATCH	/users/{id}	Mettre à jour un utilisateur
DELETE	/users/{id}	Supprimer un utilisateur
GET	/audit-logs	Récupérer les journaux d audit

Exemple de requête

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

Limitation de débit

L API est limitée à 100 requêtes par minute et par jeton. En cas de dépassement, vous recevez un statut 429 Too Many Requests.