環境
DUST は、デプロイされた 3 つのサービスとして動作します。ほとんどの連携では DUST API のみが必要です。AuthD には、API の /api/auth/* パスを介してアクセスします。
| サービス | URL | 用途 |
|---|---|---|
| DICE Web アプリ | https://dice4.dustid.io | DUST ワークフロー用の公式 Web UI。 |
| DUST API | https://apid.dustid.io | コア API。Scalar リファレンスは /api/docs にあります。 |
| AuthD | https://authd.dustid.io | アカウント、組織、セッション、OIDC、サービスアカウント。 |
API パス
Section titled “API パス”DUST API は、以下のルート以下でプラットフォームを公開します。
| パス | 用途 |
|---|---|
/api/auth/token | AuthD API キーを bearer トークンと交換します。 |
/api/auth/jwks | DUST API を介して AuthD JWKS を取得します。 |
/api/v1/* | DUST API のコア操作。 |
/api/openapi.json | API が提供する、生成済みの OpenAPI 仕様。 |
/api/docs | インタラクティブな Scalar リファレンス。 |
生成されたエンドポイントの完全なカタログについては API リファレンスを、すべての呼び出しに含まれるリクエストコンテキストヘッダーについては規約を参照してください。
ヘルスエンドポイント
Section titled “ヘルスエンドポイント”DUST API は、標準のヘルスプローブをサーバールート（/api 以下ではありません）で提供します。
| パス | 確認内容 | 障害時の動作 |
|---|---|---|
/livez | Liveness — プロセスが稼働中であること。 | サーバーの稼働中は常に 200。 |
/readyz | Readiness — データベースへのラウンドトリップを含みます。 | データベースの確認に失敗した場合、または 2 秒のタイムアウトを超えた場合は 503。 |
/healthz | Readiness 確認のエイリアス。 | /readyz と同じ。 |
正常時には、3 つすべてが { "status": "ok", "timestamp": "…" } を返します。Readiness 確認では、正常でない場合に 503 とともに { "status": "error", … } を返します。稼働時間モニターの監視先には /readyz（または /healthz）を指定してください。