---
title: "PostmanでサンプルAPI呼び出しを実行する"
slug: "execute-sample-api-calls-in-postman"
abstract: "Postmanサンプルを使ってリクエストを実行する方法Sitecore XC API。"
---
# PostmanでサンプルAPI呼び出しを実行する

[Sitecore。Experience。Commerce。](https://doc.sitecore.com/xp/ja/developers/101/sitecore-experience-commerce/sitecore-commerce-engine-sdk.html "Sitecore Commerce Engine SDK")XCソリューションの一部としてパッケージ化されたSDKには、RESTベースのAPI呼び出しをCommerce Engineに実行し、機能をテストまたは拡張するためのPostmanサンプルが含まれています。[Postman](https://www.getpostman.com/apps)は、シンプルなテストサーフェスに対してHTTPレベルの呼び出しと応答を管理するためのツールです。

Sitecore XC Postmanサンプルは、Postman RESTクライアントを用いてCommerce EngineサービスへのサンプルAPI呼び出しのセットで、呼び出しパターンと期待される結果を示します。どのHTTPテストツールでもソリューションを開発できますが、Sitecore XCで提供されたサンプルのPostmanを使い、それを選んだHTTPテストツールに転送するのが最善です。

すべてのPostmanサンプルは、Sitecore.Commerce.Engine.SDK .zipファイルの*postman*フォルダに含まれており、Sitecore XCリリースパッケージに含まれています。

Sitecore XC *postman*フォルダには、Adventure Works環境とHabitat環境の2つのサンプル環境ファイルも含まれています。これらのサンプル環境のいずれかをPostmanにインポートすることも、自分で作成することも可能です。

> !重要コマースBusiness Tools外からコマースエンジンAPIに呼び出しを行う場合(例えばPostmanを使う場合)、wwwroot\\config.jsonファイルの偽造防止設定を無効にし、IISを再起動する必要があります。そして、Postmanサンプル操作に関連付けられたコマースロールでこれを行わなければなりません。例えば、*Clone Catalog Data*操作の偽造防止設定を無効にするには、Commerce Engine [Authoringロール](https://doc.sitecore.com/xp/ja/developers/101/sitecore-experience-commerce/commerce-engine-roles.html "Commerce Engine roles")でこれを行わなければなりません。他のAPIコールを実行する前に、GetTokenリクエストを使ってベアラートークンを取得し、Sitecoreアイデンティティサーバーに対して認証する必要があります。

これらの指示は、Postmanをインストールし、アプリケーションの基本的な動作を理解していることを前提としています。より詳しい情報は[Postmanのドキュメント](https://www.getpostman.com/docs)をご参照ください。

> !重要新しいPostmanインストールでは、Commerce Engineから応答を得るためにSSL証明書認証を無効にする必要があります。これを行うには、Postmanで「ファイル」→設定をクリックし、SSL証明書認証をオフにしてください。

サンプルAPI呼びSitecore XC Postmanを使うには:

1.  Sitecore.Commerce.Engine.SDK.zipパッケージ内の*Postman*フォルダを開き、ShopsまたはDevOpsフォルダに移動します。
    
2.  Postmanアプリケーションを開き、メインメニューバーの **インポート** をクリックします。
    
    ![The Import button on the main menu bar in Postman.](https://doc.sitecore.com/api/markdown-image/xp/ja/developers/101/sitecore-experience-commerce/images/PostmanImport.png)
    
3.  Sitecore XCコレクション.jsonファイルを **インポート** ウィンドウにドラッグします。
    
    Sitecore XCコレクションファイルは*postman\\DevOps*フォルダと*postman\\Shops*フォルダー( Sitecore.Commerce.Engine.SDKパッケージ内)にあります。
    
4.  Postman**コレクション** のペインで*Authentication*コレクションを展開します。
    
5.  *Sitecore*フォルダを開き、GetTokenを選択し、**送信**をクリックしてリクエストを実行します。
    
    Postmanがボディパネルにアクセストークンを表示すると、認証が成功します。例えば:
    
    > !注この例に示されているIdentity Serverホスト名は、あなたのデプロイメントで異なる場合があります。
    
    ![Authentication token displayed in Postman body pane.](https://doc.sitecore.com/api/markdown-image/xp/ja/developers/101/sitecore-experience-commerce/images/Postman-GetToken.png)
    
6.  希望に応じてサンプルAPI呼び出しのいずれかを実行してください。
    

Sitecore XCに含まれるPostmanコレクションの全リストについては、「[Sitecore XC Postmanコレクション一覧](https://doc.sitecore.com/xp/ja/developers/101/sitecore-experience-commerce/list-of-sitecore-xc-postman-collections.html "List of Sitecore XC Postman collections") 」トピックをご覧ください。