インタラクティブAPIクライアント
インタラクティブAPIクライアントは、ALM Octane UI内からAPI呼び出しを行うことができる組み込みクライアントです。
概要
ALM Octaneユーザーは、インタラクティブAPIクライアントを使用して次のことができます。
-
サポートされているエンティティについて調べて学習します。
-
ALM Octaneにデータをリクエストします。
-
ALM Octaneのデータを変更します。
アクセスできるエンティティ、および実行できる操作は、ログインに使用するAPIアクセスクライアントIDとシークレットに割り当てられたロールと権限に基づいています。
注: サイト管理アクション (構成パラメーターの設定など) を実行するには、REST APIクライアントツールを使用してサイト管理者としてログインします。インタラクティブAPIクライアントを使用してこれらのアクションを実行することはできません。詳細については、認証を参照してください。
ALM Octaneは、インタラクティブAPIクライアントから直接、または例をコードにコピーすることで操作できます。
REST APIをインタラクティブに操作する方法
これらの手順に従って、REST APIをインタラクティブに操作します。
-
前提条件: APIアクセスクライアントIDとシークレットを取得します。詳細については、APIアクセスのセットアップを参照してください。
-
ALM Octaneヘルプメニューで、インタラクティブAPIクライアントをクリックします。
ヒント: インタラクティブAPIクライアントにアクセスする別の方法は、次のURLを使用することです:
http://<server>:<port>/ui/swagger-ui/swagger.jsp
-
クライアントIDとシークレットを入力します (ユーザー名とパスワードではありません)。
Loginをクリックします
-
ワークスペースを選択します。
-
エンティティのリソースと操作が表示されます。ロール (APIアクセスキーで定義されている) および現在のワークスペースで使用できるエンティティと操作のみが使用可能です。
Generic APIsをクリックしてすべてのリソースを表示するか、CI/CD APIsをクリックして継続的デリバリに関連するリソースのサブセットを表示できます。
エンティティリソースを折りたたむか展開して、その操作 (DELETE、GET、POST、PUT) を表示 /非表示にします。
注意: POST、PUT、およびDELETE操作は、不具合やテストの追加や編集など、データを変更します。あなたと他のユーザーは、これらの変更をALM Octaneでリアルタイムに表示できます。
-
エンティティと操作を選択し、パラメーター値を入力します。インタラクティブAPIクライアントは、たとえば、必須フィールドが欠落している場合に、リクエストを確認することでガイドします。
-
Executeをクリックして、指定したパラメーターを使用して操作を実行するか、例または構文をコードにコピーします。
返される応答コードの詳細については、エラーとステータスコードを参照してください。
参照情報: