RWS開発日記

日頃、楽天ウェブサービスのご利用、誠にありがとうございます。

 

楽天ウェブサービスへご登録いただいているお客様には既にメールにてご連絡をさせていただいておりますが、
先日の新楽天ブックス系APIのリリースに伴いまして、
今までご利用いただいていた旧楽天ブックス系APIを廃止することになりました。

 

つきましては、お客様には大変お手数をお掛けいたしますが、
下記期間内に移行・アプリの改修をいただけますよう、何卒よろしくお願いいたします。

 

■旧楽天ブックスAPIの廃止についての詳細

 

移行期間：2009年05月25日　〜　2009年07月31日
　　　　　（上記期間を過ぎますと、リクエストをされてもエラーとなります）

 

廃止対象：以下、旧楽天ブックス系API3つの全version

　　　　・楽天書籍検索API（operation名：BookSearch）
　　　　　version（2007-01-17、2007-02-14、2007-03-14、2007-03-28、2007-04-11、2007-10-25）

 

　　　　・楽天CD検索API(operation名：CDSearch)
　　　　　version（2007-01-31、2007-02-14、2007-03-14、2007-03-28、2007-04-11、2007-10-25）

 

　　　　・楽天DVD検索API(operation名：DVDSearch)
　　　　　version（2007-01-31、2007-02-14、2007-03-14、2007-03-28、2007-04-11、2007-10-25）

 

対応方法：

1.以下、新楽天ブックス系APIをご利用ください。

　　　　楽天ブックス系APIは次の9つです。

　　　　・楽天ブックス総合検索API
  　　　⇒楽天ブックス内の商品すべてから検索が可能なAPI

　　　　・楽天ブックス書籍検索API
　　　  ⇒楽天ブックス内の書籍商品の詳細検索が可能なAPI

　　　　・楽天ブックスCD検索API
 　　　 ⇒楽天ブックス内のCD商品の詳細検索が可能なAPI

　　　　・楽天ブックスDVD/Blu-ray検索API
  　　　⇒楽天ブックス内のDVD/Blu-ray商品の詳細検索が可能なAPI

　　　　・楽天ブックス洋書検索API
  　　　⇒楽天ブックス内の洋書商品の詳細検索が可能なAPI

　　　　・楽天ブックス雑誌検索API
　　　  ⇒楽天ブックス内の雑誌商品の詳細検索が可能なAPI

　　　　・楽天ブックスゲーム検索API
　　　  ⇒楽天ブックス内のゲーム商品の詳細検索が可能なAPI

　　　　・楽天ブックスソフトウェア検索API
　　　  ⇒楽天ブックス内のソフトウェア商品の詳細検索が可能なAPI

　　　　・楽天ブックスジャンル検索API
　　　  ⇒楽天ブックスのジャンル体系が検索可能なAPI

 

　　　　＜【補足】新楽天ブックス系APIの特徴＞
　　　　特徴その1：以前より皆様からリクエストの多かったISBNコードやJANコードによる検索に対応

　　　　特徴その2：商品のタイトルだけでなく、出版社やレーベル、歌手や出演者での検索も可能

　　　　特徴その3：割引率、書籍サイズ、機種、OSなど細かな情報も出力

 

　　　　より多くの用途にご利用いただける検索が可能になった新楽天ブックス系APIを
　　　　今後ともよろしくお願いいたします。皆様のご利用をお待ちしております。

 

2.楽天商品検索API（operation名：ItemSearch）を利用して移行

 

　　　　もし、上記移行期間内での移行が難しい場合や、
　　　　どうしても現在と同じ条件で商品情報を取得されたい場合は以下の方法で、
　　　　同じ結果を取得することが可能です。

 

　　　　楽天商品検索API(ItemSearch)で、
　　　　ショップコード(shopCode)に楽天ブックスのショップコードである「book」を指定、
　　　　ジャンルID(genreId)に以下のようにそれぞれIDを指定することで、
　　　　旧楽天ブックス系APIと同じ結果を返すことが可能です。

 

　　　　＜指定ジャンルID＞
　　　　楽天書籍検索API：「本・雑誌・コミック（genreId=200162）」所属のgenreIdを指定
　　　　楽天CD検索API：「CD（genreId=101311）」所属のgenreIdを指定
　　　　楽天DVD検索API ：「DVD（genreId=101354）」所属のgenreIdを指定
　　　　(ジャンル体系に関しては楽天ジャンル検索APIをご利用ください。)

 

　　　　＜移行例＞投げているリクエストを次のように変更することで同じリクエストが得られます。

　　　　・BookSearch

　　　　http://api.rakuten.co.jp/rws/1.11/rest?
　　　　developerId=[Your developerId]&
　　　　version=2007-10-25&
　　　　operation=BookSearch&
　　　　keyword=%E3%83%96%E3%83%AD%E3%82%B0

 

　　　　・ItemSearch

　　　　http://api.rakuten.co.jp/rws/2.0/rest?
　　　　developerId=[Your developerId]&
　　　　version=2009-04-15&
　　　　operation=ItemSearch&
　　　　keyword=%E3%83%96%E3%83%AD%E3%82%B0&
　　　　genreId=200162&
　　　　shopCode=book

 

皆様には大変ご迷惑をおかけいたしますが、何卒よろしくお願いいたします。
今度とも楽天ウェブサービスを宜しくお願い致します。