API Referenz
NeXusOS stellt eine offene REST-API (v2) bereit. Diese Seite beschreibt Authentifizierung, grundlegende Endpunkte und Beispiele.
Authentifizierung
Die API nutzt Bearer-Tokens. Erstelle ein Token im Admin-Panel unter Benutzer → API-Tokens und sende es bei jeder Anfrage im Header:
Authorization: Bearer YOUR_TOKEN_HEREBasis-URL
Alle Endpunkte liegen unter:
https://your-installation.example.com/api/v2Wichtige Endpunkte
| Methode | Pfad | Beschreibung |
|---|---|---|
GET |
/users |
Liste aller Benutzer |
POST |
/users |
Neuen Benutzer anlegen |
GET |
/users/{id} |
Einzelnen Benutzer abrufen |
PATCH |
/users/{id} |
Benutzer aktualisieren |
DELETE |
/users/{id} |
Benutzer löschen |
GET |
/audit-logs |
Audit-Logs abrufen |
Beispiel-Anfrage
curl -X GET https://your-installation.example.com/api/v2/users \
-H "Authorization: Bearer YOUR_TOKEN_HERE" \
-H "Accept: application/json"Rate Limiting
Die API ist auf 100 Anfragen pro Minute pro Token begrenzt. Bei Überschreitung erhältst du einen 429 Too Many Requests-Status.