DTP の REST API エンドポイントを利用すると、ビルド、静的解析、カバレッジなど、DTP でホストされるデータにプログラム的にアクセスできます。開発者は、REST API を使用して DTP と他のアプリケーションを統合できます。このセクションの内容:
認証
DTP REST API は、SSL (HTTPS) 経由でのみ使用可能です。4.9.3 より前のバージョンからアップグレードした場合は、SSL ポートを手動で有効にする必要があります。詳細については「SSL の有効化」を参照してください。
デフォルトでは、API はベーシック認証を使用します。これは、次の形式の Authorization
HTTP ヘッダーを使用して API に渡すことができます。
Authorization: Basic <username>:<password>
ユーザー名とパスワードは Base64 エンコードである必要があります。必要なユーザー名/パスワードは、DTP へのログインに必要なユーザー名/パスワードと同じです。
OpenID Connect モードで DTP を実行している場合、ベーシック認証はサポートされません。代わりに、OpenID Connect プロバイダーからの認証トークンを HTTP ヘッダーで渡す必要があります。詳細については「OpenID Connect の設定」を参照してください。
API ドキュメントへのアクセス
GUI から API のドキュメントにアクセスするには、[ヘルプ] ドロップダウン メニュー (クエスチョン マークのアイコン) から [API ドキュメント] をクリックします。
ブラウザーから API にアクセスする
ブラウザーのアドレス バーに https://host:port/grs/api と入力して API ドキュメントを参照することもできます。通常、DTP がポート番号 80 にデプロイされている場合は、URL は https://host/grs/api です。他のポートにデプロイされている場合、通常 https のポートは 8443 です。
リソースをクリックすると、そのパラメーターが表示されます。
リソース セクションの [More Information] をクリックすると、完全なドキュメントが表示されます。