Entornos
DUST se ejecuta como tres servicios desplegados. La mayoría de las integraciones solo necesitan la API de DUST; se accede a AuthD a través de las rutas /api/auth/* de la API.
| Servicio | URL | Finalidad |
|---|---|---|
| Aplicación web DICE | https://dice4.dustid.io | Interfaz web propia para los flujos de trabajo de DUST. |
| API de DUST | https://apid.dustid.io | API principal. Referencia de Scalar en /api/docs. |
| AuthD | https://authd.dustid.io | Cuentas, Organizaciones, sesiones, OIDC y Cuentas de Servicio. |
Rutas de la API
Sección titulada «Rutas de la API»La API de DUST expone la plataforma bajo estas rutas raíz:
| Ruta | Uso |
|---|---|
/api/auth/token | Intercambiar una clave de API de AuthD por un token de portador. |
/api/auth/jwks | Obtener el JWKS de AuthD a través de la API de DUST. |
/api/v1/* | Operaciones principales de la API de DUST. |
/api/openapi.json | Especificación OpenAPI generada y servida por la API. |
/api/docs | Referencia interactiva de Scalar. |
Consulta la Referencia de la API para ver el catálogo completo de endpoints generado y Convenciones para conocer los encabezados de contexto de la solicitud que incluye cada llamada.
Endpoints de estado
Sección titulada «Endpoints de estado»La API de DUST sirve sondas de estado estándar en la raíz del servidor (no bajo /api):
| Ruta | Comprobación | Comportamiento en caso de fallo |
|---|---|---|
/livez | Disponibilidad: el proceso está activo. | Siempre devuelve 200 mientras el servidor esté en ejecución. |
/readyz | Preparación: incluye una consulta de ida y vuelta a la base de datos. | Devuelve 503 si la comprobación de la base de datos falla o supera el tiempo de espera de 2 segundos. |
/healthz | Alias de la comprobación de preparación. | Igual que /readyz. |
Los tres devuelven { "status": "ok", "timestamp": "…" } cuando el estado es correcto; las comprobaciones de preparación devuelven { "status": "error", … } con un 503 cuando no lo es. Configura los monitores de disponibilidad para que consulten /readyz (o /healthz).