Node.js からGMO MakeShop データをクエリ

Ready to get started?

Learn more or sign up for a free trial:

CData API Server



API Server は、データを外部に公開します。CData API Server のOData エンドポイントを使って、Node.js からGMO MakeShop へのCRUD クエリを実行します。

CData API Server とADO.NET Provider for GMO MakeShop(もしくは220+ の他のADO.NET Providers)を使って、GMO MakeShop をOData エンドポイントして公開し、Node.js からシンプルなHTTP リクエストでクエリを実現します。本記事ではAPI Server を使ってJSON でフォーマットされたGMO MakeShop データをNode.js でリクエストする方法を説明します。

API サーバーをセットアップ

以下のステップに従って、安全なGMO MakeShop OData サービスの作成を開始します。

デプロイ

API サーバーは独自のサーバーで実行されます。Windows では、スタンドアロンサーバーまたはIIS を使用して展開できます。Java サーブレットコンテナで、API Server WAR ファイルをドロップします。詳細とハウツーについては、ヘルプドキュメントを参照してください。

API Server は、Microsoft AzureAmazon EC2Heroku にも簡単にデプロイできます。

GMO MakeShop に接続

API サーバーとADO.NET Provider for GMO MakeShop を展開した後、[Settings]->[Connections]をクリックし、API サーバー管理コンソールで新しい接続を追加してGMO MakeShop に接続するために必要な認証値とその他の接続プロパティを指定します。

GMO MakeShop に接続するには、MembersAccessCode、OrdersAccessCode、ProductsAccessCode、およびShopId が必要です。

GMO MakeShop へのアクセスの設定

MembersAccessCode、OrdersAccessCode、ProductsAccessCode、およびShopId を取得するには、以下の手順に従ってください。

  • GMO MakeShop には各API のAccessCode が必要です。
  • GMO MakeShop Store Manager にログインし、メニューの[ショップ作成]をクリックします。
  • 左ナビゲーションメニューの[外部システム連携]から任意の連携対象設定ををクリックします(メニューに表示されない場合は別途GMO MakeShop にご確認ください)。
  • 商品データ連携設定の場合:認証コードの[発行]ボタンをクリックし、ProductsAccessCode を取得します。
  • 注文データ連携設定の場合:最初に[注文情報参照]と[注文情報変更]の設定を選択します。選択後、認証コードの[発行]ボタンをクリックし、OrdersAccessCode を取得します。
  • 会員データ連携設定の場合:最初に[会員情報の(参照・登録・変更・削除)]の設定を選択します。選択後、認証コードの[発行]ボタンをクリックし、MembersAccessCode を取得します。
  • 会員認証連携設定の場合:認証コードの[発行]ボタンをクリックし、ProductsAccessCode を取得します。

GMO MakeShop アカウントの認証

次の接続プロパティを設定して接続します。

  • ShopId:接続先のGMO MakeShop Store ID を設定。GMO MakeShop Store ID はログイン用の ID と同じです。
  • OrdersAccessCode:[注文データ連携設定]から取得した[認証コード]を設定。このプロパティは Orders テーブルにアクセスする場合に必要です。
  • ProductsAccessCode:[商品データ連携設定]から取得した[認証コード]を設定。このプロパティは Products テーブルにアクセスする場合に必要です。
  • MembersAccessCode:[会員データ連携設定]から取得した[認証コード]を設定。このプロパティは Members テーブルにアクセスする場合に必要です。
  • MemberAuthenticationCode:[会員認証連携設定]から取得した[認証コード]を設定。このプロパティは MemberAuthenticationConfirm を実行する場合に必要です。
  • Password:GMO MakeShop Store Manager のログインユーザーのパスワードを指定。このプロパティは ProductCategoryRegistrationOrModification,ProductMemberGroupPriceRegistrationOrModification,ProductOptionRegistrationOrModification,ProductRegistrationOrModification を実行する場合に必要です。

次に、[Settings]->[Resources]をクリックして、API サーバーへのアクセスを許可するGMO MakeShop エンティティを選択できます。

API サーバーユーザーを承認

作成するOData サービスを決定したら、[Settings]->[Users]をクリックしてユーザーを承認します。API サーバーは、認証トークンベースの認証を使用して主要な認証スキームをサポートします。IP アドレスに基づいてアクセスを制限することもできます。ローカルマシンを除くすべてのIP アドレスはデフォルトで制限されています。SSL を使用して、接続を認証及び暗号化することができます。

Node.js からGMO MakeShop OData フィードを消費

OData フィードはNode.js で簡単に使用できます。Node.js のHTTP クライアントを使用して、API サーバーのOData エンドポイントからJSON 形式のデータをリクエストできます。リクエストを行った後、レスポンスの本文を作成し、JSON.parse() 関数を呼び出してレコードに解析できます。

以下のコードはProducts データに対して認証されたリクエストを行います。 以下のURL の例では、BrandCode カラムの値が99a87c0x3 のレコードを検索する単純なフィルターを適用しています。

var http = require('http'); http.get({ protocol: "http:", hostname:"MyServer.com", port:MyPort, path: "/api.rsc/Products?$filter=" + encodeURIComponent("BrandCode eq '99a87c0x3'"), auth:'MyUser:MyAuthtoken' }, function(res) { var body = ''; res.on('data', function(chunk) { body += chunk; }); res.on('end', function() { console.log(body); var jsonData = JSON.parse(body); }); }).on('error', function(e) { console.log("Error: ", e); });