ウォークスルー:Authoring and Management APIへのリクエストの有効化と承認

Deployでは、true値の環境変数をSitecore_GraphQL_ExposePlaygroundと名付けます。すでに存在している場合は、環境変数の値をtrueに更新してください。

環境変数を発動させるには、環境を再デプロイしてください。

Sitecore CLIのdotnet sitecore cloud loginコマンドを実行し、プロンプトに従って環境にログインしてください。

ログインすると、プロセスはアクセストークンを保存し、GraphQL IDEやHTTPリクエストに必要なAuthorizationヘッダーを設定するために使えます。 ./sitecore/user.jsonファイルからaccessTokenプロパティの値をコピーし、後で使うために保存します。

環境に合った自動化クライアントを作成しましょう。デフォルトでは、権威URLはhttps://auth.sitecorecloud.ioであり、観客URLはhttps://api.sitecorecloud.ioです。

以下のコマンドでベアラートークンをリクエストします:

curl --location --request POST '<authority-url>/oauth/token' --header 'Content-Type: application/x-www-form-urlencoded' --data-urlencode 'client_id=<your-client-id>' --data-urlencode 'client_secret=<your-client-secret>' --data-urlencode 'audience=<audience-url>' --data-urlencode 'grant_type=client_credentials'

プレースホルダーは以下のように置き換えます:

成功した場合、応答はコンソールに印刷されます。

{
  "access_token":"eyJhbGciOiJSUzI1NiIs...",
  "scope":"xmcloud.cm:admin",
  "expires_in":900,
  "token_type":"Bearer"
}

レスポンスから引用符なしのaccess_token値をコピーし、トークンを後で使うために保存してください。

OpenブラウザのIDE https://<your-server>/sitecore/api/authoring/graphql/ide/。

IDEの左下ペインのHTTP Headersタブで、以下の形式で認可ヘッダーを追加してください:

{
    "Authorization": "Bearer <access-token>"
}

<access-token>のプレースホルダーをコピーした値に置き換えてください。

IDEの端点フィールド( Historyタブの右側)で、端点がhttps://<your-instance>/sitecore/api/authoring/graphql/v1/であることを確認します。

セットアップをクエリで確認してください。例えば：

query {
  sites {
    name
  }
}

設定が正しければ、回答にはあなたのウェブサイトのリストが含まれています。例えば：

{
  "data": {
    "sites": [
      {
        "name": "Winter Wonderland"
      },
      {
        "name": "website"
      }
    ]
  }
}