版元ドットコムのAPI | 版元ドットコム

こちらは旧APIの仕様のページになります。最新の仕様は→こちら

●版元ドットコム・書誌情報API

概要

版元ドットコムでは、書誌情報の一層の活用促進の一環として、書誌情報APIの整備を進めています。このAPIを利用することで、外部のプログラムから版元ドットコム会員社の書誌情報を取得して利用することが可能になります。ぜひ、ご活用ください。

現在、公開されているAPIはRESTをサポートしており、取得されるXML文書の構成はAmazonのProduct Advertising APIに近似しています。

なお、仕様は予告なしに変更されることがあります。あらかじめご了承ください。

チュートリアル

ISBNによって書誌を特定する方法

以下のようなコードでアクセスすることができます。

http://www.hanmoto.com/api/Operation=ItemLookup&ItemId=978-4-7808-0142-2&enc=UTF-8

ItemId=の部分にはISBNを入れます
ISBNは、「ハイフンあり13ケタ」「ハイフンなし13ケタ」「ハイフンあり10ケタ(旧規格)」「ハイフンなし10ケタ(旧規格)」の4通りのいずれでもアクセスが可能です

返される XML は以下のようになります。

<?xml version="1.0" ?> <ItemLookupResponse xmlns="http://www.hanmoto.com/HanmotocomWebapiService/2010-02-19"> <OperationRequest> <HTTPHeaders> <Header Name="UserAgent" Value="Mozilla/5.0 (Macintosh; U; Intel Mac OS X 10.5; ja-JP-mac; rv:1.9.2) Gecko/20100115 Firefox/3.6"></Header></HTTPHeaders> <RequestId>0d376904-5694-4d37-81d8-fe98afd19b17</RequestId> <Arguments> <Argument Name="Operation" Value="ItemLookup"></Argument> <Argument Name="Service" Value="HanmotocomWebapiService"></Argument> <Argument Name="Signature" Value=""></Argument> <Argument Name="Version" Value="2009-03-31"></Argument> <Argument Name="ItemId" Value=""/> <Argument Name="AWSAccessKeyId" Value=""></Argument> <Argument Name="Timestamp" Value="2010-02-19T05:53:30Z"></Argument> <Argument Name="ResponseGroup" Value=""></Argument> </Arguments> <RequestProcessingTime></RequestProcessingTime> </OperationRequest> <Items> <Request> <IsValid>True</IsValid> <ItemLookupRequest> <Condition>New</Condition> <DeliveryMethod>Ship</DeliveryMethod> <IdType>ASIN</IdType> <MerchantId>Hanmotocom</MerchantId> <OfferPage>1</OfferPage> <ItemId>4780801427</ItemId> <ResponseGroup></ResponseGroup> <ReviewPage>1</ReviewPage> <ReviewSort>-SubmissionDate</ReviewSort> <VariationPage>All</VariationPage> </ItemLookupRequest> </Request> <Item> <ASIN>4780801427</ASIN> <DetailPageURL>http://www.hanmoto.com/bd/ISBN978-4-7808-0142-2.html</DetailPageURL>

(以下略)

キーワードで書誌を検索する方法

以下のようなコードでアクセスすることができます。

http://www.hanmoto.com/api/Operation=ItemSearch&SearchIndex=Books&Keywords=書店営業石塚

Keywords=の部分に、検索したい単語を入れます。
単語はスペースで区切ることにより、AND検索されます。
書誌データベースの主要な項目全てを対象に検索します
当面、最大表示件数は1000件までとします

リファレンス

Item
取得した書誌の情報セット: DetailPageURL
書誌情報の存在するURL: ItemLinks
書誌情報に関連するリンク先の情報セット: MediumImage
書影(横幅200ピクセル)に関連するリンク先の情報セット。URL, Height, Width を含む: LargeImage
書影(登録したままの実サイズ)に関連するリンク先の情報セット。URL, Height, Width を含む: ItemAttributes
書誌についての基本的な情報セット。: Author
代表的(一人めに登録されている)著者 ※かならずしも「著者」とは限らない。「編」「監修」「絵」等の場合も「Author」となる: Binding
商品の形態。(基本的に「単行本」): EAN
EANコード(実質的にはJANコード) 参考→ EANコード – Wikipedia: ISBN
ISBNコード ※ここでは、AmazonのAPIと互換性を保つため、10ケタ・ハイフン無しのものが入る: LABEL
レーベル名(発行社(者)の情報が入る): ListPrice
価格情報セット。 Amount, CurrencyCode, FormattedPriceが含まれる: Manufacturer
製造者名(発行社(者)の情報が入る): NumberOfPages
ページ数: PublicationDate
発行年月: Publisher
発行社名(発行社(者)の情報が入る): Studio
製作社名(発行社(者)の情報が入る): Title
書名

書影について

版元ドットコムでは、書影についても販売・紹介目的の場合にはご自由に使用できます。

以下のようにISBNで指定するだけで簡単に取得できます(ISBNは、ハイフンなしでも可、です)。

例： http://www.hanmoto.com/bd/img/978-4-7808-0172-9.jpg

また、以下のように記述すると、動的にリサイズしつつ取得することが可能です。

例： http://www.hanmoto.com/bd/img/image.php/978-4-7808-0172-9.jpg?width=200&image=/bd/img/7808/978-4-7808-0172-9.jpg

「http://www.hanmoto.com/bd/img/image.php/ISBN(13ケタ).jpg?width=横幅&image=/bd/img/ISBNの出版社記号部分/ISBN(13ケタ).jpg」という構造になっています。

負荷低減のため、書誌・書影ともに利用者側でのキャッシング処理を推奨します。

●版元ドットコム・フィード仕様

フィード(RSSフィード)とは?

フィード(RSSフィード)の、「RSS（Rich Site Summary または RDF Site Summary）」とは、更新情報を提供するためのフォーマットの一つで、XMLを利用して記述されています。コンテンツのタイトルやそのURL、簡単な説明文などを流通させるための事実上の標準としてみなされています。これらを配信する仕組みが、「フィード(RSSフィード)」と呼ばれています。

FirefoxやSafariのような、RSS対応のブラウザやRSSリーダーで、サイトの更新情報を便利に活用できます。また、他のサイトでヘッドライン情報のような形で利用することも可能です。

当サイトが提供するRSSフィードのうち、書影を除く書誌情報は、販売・紹介目的での利用に限り利用を認めます。それ以外の情報の著作権は、日本における著作権の保護対象範囲内においてそれぞれの著作者にあります。

版元ドットコムサイトでは、以下、複数の種類のフィード情報を、複数のフォーマットで配信しています。

検索結果フィードについて

書誌を検索した結果をフィードの形で配信しています。形式は以下の3つです。
<link rel="〜">によってページに埋めこまれているので、Firefox等のモダンなブラウザであれば、ブラウザ自体が存在を検知します。アドレスバー近辺より簡単に取得することができるでしょう。

RSS2.0

URLの例: http://www.hanmoto.com/bd/search/index.php?SearchShuppansha=%E3%83%9D%E3%83%83%E3%83%88%E5%87%BA%E7%89%88&flg_searchmode=shousai&ORDERBY=DateShuppan&ORDERBY2=DateShotenhatsubai&SORTORDER=DESC&enc=UTF-8&action_search_do4feed=true&searchqueryword=%20%E5%87%BA%E7%89%88%E8%80%85%EF%BC%88%E3%81%BE%E3%81%9F%E3%81%AF%E7%99%BA%E5%A3%B2%E8%80%85%EF%BC%89=%E3%83%9D%E3%83%83%E3%83%88%E5%87%BA%E7%89%88

MODS+RSS2.0

図書館あるいはその周辺業界・研究者向けに、MODS形式でも配信しています。MODSフォーマットを、RSS2.0でラップした形にしてあります。

URLの例: http://www.hanmoto.com/bd/search/index.php?SearchShuppansha=%E3%83%9D%E3%83%83%E3%83%88%E5%87%BA%E7%89%88&flg_searchmode=shousai&ORDERBY=DateShuppan&ORDERBY2=DateShotenhatsubai&SORTORDER=DESC&enc=UTF-8&action_search_do4api=true&format=R2MODS&searchqueryword=%20%E5%87%BA%E7%89%88%E8%80%85%EF%BC%88%E3%81%BE%E3%81%9F%E3%81%AF%E7%99%BA%E5%A3%B2%E8%80%85%EF%BC%89=%E3%83%9D%E3%83%83%E3%83%88%E5%87%BA%E7%89%88

MediaRSS

CoolirisのサイトでCooliris Express(http://www.cooliris.com/yoursite/express/builder/)などに渡して活用できます。

新刊フィードについて

内容：版元ドットコムサイトに登録された書誌情報のうち、刊行されたものを配信(発売日降順)
URL: http://www.hanmoto.com/bd/shinkan/feed/
フォーマット：RSS2.0

近刊フィードについて

内容：版元ドットコムサイトに登録された書誌情報のうち、刊行される前のものを配信(発売予定日昇順)
URL: http://www.hanmoto.com/bd/kinkan/feed/
フォーマット：RSS2.0

「お知らせ」フィードについて

内容：「お知らせ」の新着フィードを配信
URL: http://www.hanmoto.com/news/feed/atom/
フォーマット：Atom

「書店FAX DM」フィード

内容：「お知らせ」のうち、書店向けに出しているFAX DMの内容そのものの新着フィードを配信
URL: http://www.hanmoto.com/news/feed/?cat=5
フォーマット：RSS2.0

「版元日誌」フィードについて

内容：「版元日誌」の新着フィードを配信
URL: http://www.hanmoto.com/diary/feed/atom/
フォーマット：Atom

問い合わせ先

版元ドットコム事務局まで、こちらのフォームからお問い合わせください。

免責事項

このAPIを利用して、またはこれに関連してユーザーが開発するアプリケーション、および本APIの利用、その信頼、またはこれを参照することに関して生じうるあらゆる損害、責任、およびクレームに関し、版元ドットコムは責任を負いません。

このAPIの利用者は、利用の伴って発生した当人または第三者の一切の損害（ただし、当社に故意または重過失がある場合は除きます）についてその賠償責任を負わないことを承諾するものとします。

参考資料

rssについて RSS – Wikipedia
mRSS(Media RSS)について Media RSS – Wikipedia, the free encyclopedia
modsについて Metadata Object Description Schema: MODS (Library of Congress)
AmazonのWebサービスについて(Amazon Product Advertising API) Product Advertising API

変更履歴

2010-04-01 RSSフィードについて記述を補足・追加
2010-02-19 公開