Environnements

DUST s’exécute sous la forme de trois services déployés. La plupart des intégrations nécessitent uniquement l’API DUST ; AuthD est accessible via les chemins /api/auth/* de l’API.

Service	URL	Fonction
Application web DICE	https://dice4.dustid.io	Interface web propriétaire pour les processus DUST.
API DUST	https://apid.dustid.io	API principale. Référence Scalar sous /api/docs.
AuthD	https://authd.dustid.io	Comptes, organisations, sessions, OIDC et comptes de service.

Chemins de l’API

L’API DUST expose la plateforme sous les chemins racine suivants :

Chemin	Utilisation
/api/auth/token	Échanger une clé API AuthD contre un jeton porteur.
/api/auth/jwks	Récupérer le JWKS d’AuthD via l’API DUST.
/api/v1/*	Opérations principales de l’API DUST.
/api/openapi.json	Spécification OpenAPI générée et servie par l’API.
/api/docs	Référence Scalar interactive.

Consultez la Référence de l’API pour obtenir le catalogue complet des points de terminaison générés, ainsi que les Conventions pour connaître les en-têtes de contexte de requête inclus dans chaque appel.

Points de terminaison d’état

L’API DUST fournit des sondes d’état standard à la racine du serveur (et non sous /api) :

Chemin	Vérification	Comportement en cas d’échec
/livez	Activité — le processus est en cours d’exécution.	Renvoie toujours 200 tant que le serveur fonctionne.
/readyz	Disponibilité — inclut un aller-retour vers la base de données.	Renvoie 503 si la vérification de la base de données échoue ou dépasse son délai d’expiration de 2 secondes.
/healthz	Alias de la vérification de disponibilité.	Identique à /readyz.

Tous les trois renvoient { "status": "ok", "timestamp": "…" } lorsqu’ils sont opérationnels ; lorsqu’ils ne le sont pas, les contrôles de disponibilité renvoient { "status": "error", … } avec un code 503. Configurez les outils de surveillance de disponibilité pour interroger /readyz (ou /healthz).