「テスト」タブを使用した GraphQL API のテスト

GraphQL API 定義の場合、「テスト」タブに GraphiQL エディターが含まれます。 GraphiQL エディターを使用して、GraphQL 照会を作成できます。 GraphQL API をテストすると、GraphiQL エディターに応答が表示されます。

以下のいずれかの方法で GraphQL 照会をテストできます。

POST 操作を使用します。この場合、照会は操作要求の本文で送信されます。
GET 操作を使用します。この場合、照会は照会パラメーターとして送信されます。

操作タイプごとに、照会を GraphQL API エンドポイント自体に対してテストすることも、要求のコストの詳細を GraphQL API エンドポイントに返すコスト・エンドポイントに対してテストすることもできます。

どちらの方法およびエンドポイントを使用する場合でも、照会を直接指定することも、GraphiQL エディターを使用して照会を作成することもできます。エディターは、API に対して定義されたスキーマに基づいて先行入力機能を提供するほか、エラーを強調表示して修正の提案を示します。スキーマは、GraphQL API の定義の作成時に最初にアップロードされていますが、その後に変更されている可能性があります。 GraphQL API 定義の作成について詳しくは、 GraphQL プロキシー API の作成を参照してください。スキーマの変更について詳しくは、 GraphQL スキーマ・エディターの使用を参照してください。

開始前に

「テスト」タブでテストするために API 定義が満たす必要がある要件については、「テスト」タブでデバッグするための API の準備を参照してください。

手順

「要求」セクションで、目的の操作タイプとエンドポイントを選択します。例えば、以下のようにします。
- POST https://myserver.com/myorg/sandbox/mybasepath/graphql
- GET https://myserver.com/myorg/sandbox/mybasepath/graphql/cost
エディターの左側のペインにある「GraphiQL」タブで照会を指定します。例えば、以下のようにします。
```
{
  accounts(limit: 100) {
    name {
      first
      last
    }
  }
}
```
必要に応じて、「パラメーター」タブで追加の要求ヘッダーを指定することができます。
照会に変数が含まれている場合は、「Query Variables」ペインで変数の値を指定できます。例えば、以下のような照会であるとします。
```
query MyQuery($Query__accounts__limit: Int)
{
  accounts(limit: $Query__accounts__limit) {
    name {
      first
      last
    }
  }
}
```
「クエリー変数」ペインに以下を入力して、 Query__accounts__limit の値を設定できます。
```
{
  "Query__accounts__limit": variable_value
}
```
ここで、variable_value は必須値です。
エディターで「送信」または「照会の実行」アイコンをクリックします。 GraphiQL エディターに応答が表示され、「トレース」セクションに API 呼び出しがどのように実行されたかが示されます。トレース情報について詳しくは、トレースの検査を参照してください。