honjp/api/rest/21

電子書籍検索

電子書籍を検索します。

リクエスト時のパラメータの設定方法が特殊です。
[keyword]:URLエンコードした検索キーワードを指定します。
[friend_id]:おともだちIDを指定します。
[parameter]:その他のパラメータを&で繋いで指定します。

[parameter]の指定ですが、? は付きません。
いわゆるURL引数ではないことにご注意ください。

api URL

api url
http://hon.jp/rest/2.1/[keyword]/[friend_id]/[parameter]
format
xml
method
GET
認証
不要
実行制限
なし
公式ドキュメント
http://hon.jp/doc/about_rest.html

parameter set

parameter value 省略 説明
keyword 必須 検索キーワード。
friend_id
MyApiKey-friend_id をセット
必須 お友達ID。
[MyApiKey-friend_id]を指定すると、Apiキーを預けるで設定されたApiキーに自動変換します。
hardware 動作ハードウェア。数字2桁。
os 動作OS。数字2桁。
viewer 動作ビューワ。数字2桁。
shop 電子書籍販売サイトID。英大4桁。
payment 決済方法。英大2桁。
genre1 第一分類。数字3桁。
genre2 第二分類。数字3桁。
genre3 第三分類。数字3桁。
isbn13 紙書籍が存在する場合、ISBNコード。ハイフンなし13桁。旧10桁は未対応。
description50 キャッチコピーの表示フラグ。
publ 出版社ID。英大4桁。
sort 表示順。
max 1ページあたりの表示件数。省略時は10。
page 表示ページ番号。1~
mode XML出力モード。省略時はfull。
xslt 省略または「xml」を指定でXML出力。XSLTを使う場合はXSLTの場所のURL。

取得形式 :

call results

[call update]ボタンを押してください。ここに結果が表示されます。

  • このデータは、jsonpで取得しjabascriptオブジェクトに変換されたものを再度json形式に変換した結果です。
  • 受信されるデータと厳密に同じでないことをご理解ください。

発行したAPIのURLとパラメータ

下記のURLで、本ページの各パラメータに自動的にセットされます。

開発メンバー間でパラメータの指定例をメールで送信したり、ブログやホームページでApiの説明を書く際にお使いください。
※パラメータにApiキーなどが含まれる場合はご注意ください。

  • javascriptでは桁数の大きな数値で値がズレることがあります。
  • 例えば、twitterの id_str と id です。
  • id_str は文字列型ですので正しい値が表示されます。
  • id は数値型です。桁数が大きな場合、 +-1のズレが発生することがあります。
  • id_str と id が異なる場合は、id_str を信用してください。
  • 試しに下記をクリックして実行してみてください。期待する値がalertされるでしょうか?
  • javascript:eval('var a = 13782936788668417, b = \'13782936788668417\';'); alert(a+' : 数値型'+'\n\n'+b+' : 文字列型');
  • 本サイトでは、javascriptで処理をしている関係上、apiから取得してきたデータと異なることがあります。
  • あらかじめご理解・ご了承ください。