Umgebungen
DUST wird in Form von drei bereitgestellten Diensten ausgeführt. Die meisten Integrationen benötigen nur die DUST API; AuthD ist über die /api/auth/*-Pfade der API erreichbar.
| Dienst | URL | Zweck |
|---|---|---|
| DICE-Web-App | https://dice4.dustid.io | Hauseigene Web-Benutzeroberfläche für DUST-Workflows. |
| DUST API | https://apid.dustid.io | Zentrale API. Scalar-Referenz unter /api/docs. |
| AuthD | https://authd.dustid.io | Konten, Organisationen, Sitzungen, OIDC und Dienstkonten. |
API-Pfade
Abschnitt betitelt „API-Pfade“Die DUST API stellt die Plattform unter diesen Stammpfaden bereit:
| Pfad | Verwendung |
|---|---|
/api/auth/token | Einen AuthD-API-Schlüssel gegen ein Bearer-Token austauschen. |
/api/auth/jwks | AuthD-JWKS über die DUST API abrufen. |
/api/v1/* | Zentrale DUST-API-Operationen. |
/api/openapi.json | Von der API bereitgestellte, generierte OpenAPI-Spezifikation. |
/api/docs | Interaktive Scalar-Referenz. |
Den vollständigen generierten Endpunktkatalog finden Sie in der API-Referenz; die Konventionen beschreiben die Anfragekontext-Header, die bei jedem Aufruf übermittelt werden.
Zustandsendpunkte
Abschnitt betitelt „Zustandsendpunkte“Die DUST API stellt standardmäßige Zustandsprüfungen im Stammverzeichnis des Servers bereit (nicht unter /api):
| Pfad | Prüfung | Verhalten bei einem Fehler |
|---|---|---|
/livez | Erreichbarkeit — der Prozess wird ausgeführt. | Gibt stets 200 zurück, solange der Server läuft. |
/readyz | Bereitschaft — umfasst einen vollständigen Datenbankzugriff. | 503, wenn die Datenbankprüfung fehlschlägt oder ihr Zeitlimit von 2 Sekunden überschreitet. |
/healthz | Alias für die Bereitschaftsprüfung. | Identisch mit /readyz. |
Bei fehlerfreiem Zustand geben alle drei { "status": "ok", "timestamp": "…" } zurück; andernfalls geben die Bereitschaftsprüfungen { "status": "error", … } mit dem Statuscode 503 zurück. Richten Sie Verfügbarkeitsmonitore auf /readyz (oder /healthz).