Ambienti

DUST viene eseguito come tre servizi distribuiti. La maggior parte delle integrazioni richiede solo l’API DUST; AuthD è accessibile tramite i percorsi /api/auth/* dell’API.

Servizio	URL	Scopo
Applicazione web DICE	https://dice4.dustid.io	Interfaccia web proprietaria per i flussi di lavoro DUST.
API DUST	https://apid.dustid.io	API principale. Riferimento Scalar disponibile in /api/docs.
AuthD	https://authd.dustid.io	Account, Organizzazioni, sessioni, OIDC e account di servizio.

Percorsi API

L’API DUST espone la piattaforma nelle seguenti radici:

Percorso	Utilizzo
/api/auth/token	Scambia una chiave API AuthD con un bearer token.
/api/auth/jwks	Recupera i JWKS di AuthD tramite l’API DUST.
/api/v1/*	Operazioni principali dell’API DUST.
/api/openapi.json	Specifica OpenAPI generata e fornita dall’API.
/api/docs	Riferimento Scalar interattivo.

Consulta il Riferimento API per il catalogo completo degli endpoint generati e le Convenzioni per le intestazioni di contesto della richiesta incluse in ogni chiamata.

Endpoint di controllo dello stato

L’API DUST fornisce sonde standard di controllo dello stato nella radice del server (non sotto /api):

Percorso	Controllo	Comportamento in caso di errore
/livez	Vitalità — il processo è in esecuzione.	Restituisce sempre 200 mentre il server è in esecuzione.
/readyz	Disponibilità — include una richiesta di andata e ritorno al database.	Restituisce 503 se il controllo del database non riesce o supera il timeout di 2 secondi.
/healthz	Alias del controllo di disponibilità.	Come /readyz.

Quando il servizio funziona correttamente, tutti e tre restituiscono { "status": "ok", "timestamp": "…" }; in caso contrario, i controlli di disponibilità restituiscono { "status": "error", … } con un codice 503. Configura i monitor di disponibilità su /readyz (o /healthz).