API Console の使用

API Console は、REST API とそのメソッドに関する情報を表示し、要求を送信してメソッドをテストできる対話型コンポーネントです。API Console は [API Details (API 詳細)] ページにあります。エンドポイントはアルファベット順に表示されます。

API Console には、オンボーディングプロセスや適応性にとって重要な API の仕様とドキュメントの情報が表示されます。開発者は API の使用法と統合方法を知っておくと役立ちます。

[Specification (仕様)] ペインには REST API の REST 仕様の HTTP 関数のナビゲーションが表示されます。リソースやメソッドを確認することで、出力の形式や構造を理解できます。

[Documentation (ドキュメント)] ペインには API に関する対話型のドキュメントが表示されます。API ドキュメントには、各 API バージョンの詳細な説明が含まれます。このドキュメントは、API リリースサイクルで更新され、通常は開発チームが更新に深く関与します。要求の情報や応答を確認することもできます。

[Try it (試す)] ペインでは、モッキングサービスまたは API インスタンス URL を使用して REST API をテストできます。モッキングサービスを使用すると、要求と応答を処理する実際のサーバーを使用せずに、API 仕様で定義されたエンドポイントをテストできます。モッキングサービスでは、シミュレーションデータを API 関数に追加し、そのデータを使用して API をテストできます。すべての応答はサンプルデータです。API インスタンスを使用すると、サーバーと対話し、実際の要求と応答の実際のデータを取得できるようになります。

API 仕様とドキュメントを確認する

API に関する情報を見つける手順は、次のとおりです。

  1. [Home (ホーム)]​ または ​[APIs (API)]​ ページで、API を選択します。

  2. [API specification (API 仕様)]​ タブを選択します。

  3. [Specification (仕様)]​ ペインで、関数をクリックします。

  4. [Documentation (ドキュメント)]​ ペインで、関数の概要を確認します。

  5. [Requests (要求)]​ タブを選択して、コード例、パラメーター、セキュリティ、ヘッダー、例、本文に関する情報を表示します。

  6. [Responses (応答)]​ タブを選択して、応答種別、例、ヘッダー、本文を表示します。

API をテストする

シミュレーションデータが必要な場合は、モッキングサービスを使用して API 仕様をテストできます。API のインスタンスを使用して、実際のデータで API 仕様をテストすることもできます。インスタンスに認証ヘッダーがある場合、認証ヘッダーが入力されていないと要求は失敗します。

API のテストについての詳細は、次のトピックを参照してください。