電脳卸Webサービス初心者入門講座

電脳卸リクエストパラメータについて。

mslab — 2008-02-28T18:05:06+09:00

電脳卸WEBサービス で API にリクエストする時の、リクエストパラメータについては、ダウンロードしたマニュアル(DWS ガイド)に、詳しく書かれています。

マニュアルを見ると「accesskey」は必須ですが、その他のパラメータは省略できます。しかし sword(検索対象ワード)だけでも指定したほうがいいです。

【1】前に使った利用例で、リクエストパラメータの基本的な使い方を説明します。

・例「化粧品」

http://webservice.d-064.com/2.0/ProductSearch.php?
accesskey=あなたのアクセスキー(アクセスコードのこと)
&sword=%E5%8C%96%E7%B2%A7%E5%93%81
&sort_mode=0
&sort=0
&offset=30
&page=1

(1)商品情報検索API のURLです。

http://webservice.d-064.com/2.0/ProductSearch.php?

(2)販売店ごとに与えられた、アクセスコードを指定している部分です。

accesskey=あなたのアクセスコード

(3)検索対象ワードを指定している部分です。

&sword=%E5%8C%96%E7%B2%A7%E5%93%81

検索対象ワードは UTF-8 形式でエンコードします。これは URL に使える文字の種類が限られているため、URLに使える文字列に置き換える必要があるからです。

エンコードは以下のサイトから行なえます。
エンコード・デコード

・例

(4)ソートの条件を指定している部分です。

&sort_mode=0

0:新着順(標準値) 1:価格順

(5)ソート順を指定している部分です。

&sort=0

0:昇順 1:降順

(6) 1ページに表示する商品数を指定している部分です。

&offset=30

(7)ページ番号を指定している部分です。

&page=1

【2】検索対象ワードを変えて、様々な商品の XML データを取得してみてください。

＊検索対象ワードはエンコードしてください。

【3】またソート条件、ソート順、1ページに表示する商品数、ページ番号を変えてみて、データがどのように変化するのか確認してください。

XML データの取得に慣れることが目的です。

電脳卸 XML形式の商品情報の意味について。

mslab — 2008-02-28T16:01:00+09:00

今回は 電脳卸WEBサービス の「商品情報検索API」で取得した、XMLデータ(商品情報)の読み方について説明します。

レスポンスについては、ダウンロードしたマニュアル(DWS ガイド)に、詳しく書かれています。

【1】前回の利用例と同じように URL でリクエストして、XMLを表示してください。

それでは XML を詳しく見ていきましょう。

【2】パラメータのアクセスコードから、自動的に販売店ID(Hid)が表示されています。

【3】総商品数(TotalItems)と、総ページ数(TotalPages)がわかります。

＊総商品数や総ページ数は、ページの切り替えと関係してきます。

【4】

から

までが、一つの商品に関するデータです。

【5】商品番号(ItemID)、ショップID(ShopID)、商品名(ProductName)、商品価格(Price)が表示されています。

【6】ImageUrl は商品写真ですが、画像サイズが大中小用意されています。

＊商品のURLをブラウザのアドレスに貼り付けると、商品画像が表示できます。

【7】DetailURL はパソコン用の販売ページ、MobileURL は携帯電話用の販売ページへのリンクです。

＊リンクには販売店ID(Hid)が含まれているため、アフィリエイトリンクになっていて、成果報酬が得られる仕組みです。

・パソコン用の販売ページ

・携帯電話用の販売ページ

【8】メーカー(Manufacture)、送付までの間隔(Availability)、商品在庫数(Stock)、商品数無限大(StockInfinity)つまり制限がないか、という情報が表示されています。

【9】商品コメント(ItemDetail)が表示されています。

＊商品コメントが長い場合は、プログラムで文章を切り出して使うこともあります。

【10】販売状況(SalesStatus)、カテゴリＩＤ(CategoryID)が表示されています。

電脳卸 XML形式の商品データを表示する方法。

mslab — 2008-02-28T14:01:11+09:00

電脳卸WEBサービス (DWS) で商品情報を取得して、動的なネットショップなどの、新たなWebアプリケーションを制作するには、電脳卸WEBサービス API の使い方を知る必要があります。

電脳卸WEBサービスの API は、URLでリクエスト(要求)すると、XML 形式のデータをレスポンス(応答)します。URLにはパラメータとして、いろいろな条件を含めることができます。

これは他社のWebサービスでも、大体同じ仕組みです。API の使い方を一つ覚えると応用できます。

電脳卸の場合、各 API のリクエスト・レスポンスについては、前回ダウンロードしたマニュアル(DWS ガイド)に詳しく書かれています。

電脳卸WEBサービスの API で最も基本となるのが、「商品情報検索API」です。キーワードで商品を検索することができます。まずはこの API の使い方を覚えましょう。

【1】マニュアル(DWS ガイド)を開いて、商品情報検索API のリクエストパラメータの説明を見ます。

「accesskey」は必須ですが、その他のパラメータは省略できるようです。

でも通常は商品数が多すぎるので、検索対象ワードで絞り込みます。そのため「sword」も使います。他にも、「sort_mode、sort、offset、page」は指定したほうがよいでしょう。

【2】URLでリクエストする場合の利用例を掲載しました。コピーして試してみましょう。

以下は「化粧品」で検索して、新着順の昇順で、1ページに30商品、その1ページ目を表示するという意味になります。

・例「化粧品」

http://webservice.d-064.com/2.0/ProductSearch.php?
accesskey=あなたのアクセスキー(アクセスコードのこと)
&sword=%E5%8C%96%E7%B2%A7%E5%93%81
&sort_mode=0
&sort=0
&offset=30
&page=1

もちろんアクセスキーは、あなたのものに変更します。

ポイントは、URLに日本語は使えないため、検索対象ワードは UTF-8 形式でエンコードしていることです。エンコードについてはのちに説明します。

利用例では、見やすいように改行しています。しかし実際に使うときは、改行しないで1行にしてからコピーしてください。

【3】Webブラウザを起動して、アドレスに上記の利用例を貼り付け、「移動」ボタンをクリックします。

＊改行せず1行にしてください。

【4】XML 形式の商品データが取得できました。

取得した XML を利用して、Ajax で HTML に組み立てると、動的なネットショップが作成できます。

電脳卸WEBサービスに申し込み、アクセスコードを取得する方法。

mslab — 2008-02-27T22:47:22+09:00

電脳卸WEBサービス を利用するには、販売店登録(無料)が済んだ後、電脳卸WEBサービスを使用するための「申し込み」(無料)が必要です。

今回の手順をまとめると、以下のようになります。

1.販売店登録(無料)
↓
2.電脳卸WEBサービス申し込み(無料)
↓
3.アクセスコードを取得
↓
4.マニュアル(DWS ガイド)をダウンロード
↓
5.電脳卸デベロッパーズサービスブログを見る

＊電脳卸の販売店とは、アフィリエイターのことです。

【1】電脳卸で販売店ログインしてください。

電脳卸の販売店登録がまだの場合はこちらから行なえます。

【2】販売店ログインすると、電脳卸WEBサービスへのリンクがあるので、クリックします。

【3】利用規約を読んで、「利用規約に同意する」にチェックを入れ、「申し込む」ボタンをクリックします。

【4】DWSユーザー登録が完了しました。

＊このアクセスコードは重要ですので、テキストエディタなどにコピーしておいてください。

【5】申し込みと同じ画面から、電脳卸WEBサービスのマニュアルがダウンロードできます。

【6】マウスで「DWSサービスガイド」を右クリックし、コンテキストメニューから、「対象をファイルに保存」を選択します。

【7】マニュアルがダウンロードできました。

【8】マニュアルは PDF ファイルになっています。

＊API 仕様詳細には、リクエストパラメータやレスポンスについて書かれています。

【9】また「電脳卸デベロッパーズサービスブログ」も役立ちます。

このブログには開発に関する情報が、いろいろ掲載されています。ウェブブラウザのお気に入りに追加しておくと便利です。

電脳卸WEBサービスとは？

mslab — 2008-02-27T20:29:55+09:00

電脳卸WEBサービス (DWS) とは、電脳卸が提供している十数万点の商品データを、販売店(アフィリエイター)が利用することができる Webサービスです。

電脳卸でいう販売店とは、アフィリエイターのことです。もちろん販売店登録は無料です。電脳卸では販売店登録すると、Webサービスも無料で利用できます。

電脳卸の販売店登録はこちらから行なえます。

電脳卸WEBサービスを使うと、電脳卸が持つ膨大な商品データを検索して、その結果を XML 形式で取得することができます。取得した XML をプログラムで解析して、HTMLを組み立てることで、動的なWebサイトが簡単に作成できます。

実際に電脳卸WEBサービスを使った、ウェブサイトの利用例をご覧ください。

・除毛
・洗浄機

このようにキーワードに対応したページが自動的に表示されます。動的な Webサイトだと、更新の手間もかかりません。電脳卸のデータが更新されると、自動的に更新されます。

しかも商品リンクから成果報酬を得ることができます。電脳卸の報酬は比較的高く、結果が出しやすいアフィリエイトプログラムの一つです。

なんといっても自分だけのネットショップが、簡単にできるのが魅力です。アイデア次第で面白いネットショップが生まれるかもしれません。

この「電脳卸WEBサービス初心者入門講座」では、 Ajax を使って電脳卸WEBサービスを活用する方法を、初心者向けに図を交えて詳しく説明します。

電脳卸Webサービス初心者入門講座

電脳卸 リクエストパラメータについて。

電脳卸 XML形式の商品情報の意味について。

電脳卸 XML形式の商品データを表示する方法。

電脳卸WEBサービスに申し込み、アクセスコードを取得する方法。

電脳卸WEBサービスとは？

電脳卸リクエストパラメータについて。