ALIS WebOPAC OpenSearch クエリパラメータとレスポンス仕様

クエリパラメータ

OpenSearchクエリは以下の形式です。

	http://library.affrc.go.jp/api/opnsrhb.do?(パラメータ=値)&(パラメータ=値)&…(パラメータ=値)

クエリを構成するパラメータは以下の通りです。

No.	パラメータ	内容
1	q	「フリーワード」を指定するパラメータ。内部的には、keywdとして検索を実施する。Keywdと合わせて検索を行った場合、qとkeywdを、keywdのAND検索として利用。
2	format	OpenSearchの返却フォーマットの指定を行う。atom, rss, marc, rdf, dcndlを指定可能。
3	keywd	「キーワード」を指定するパラメータ。qと合わせて検索を行った場合、qとkeywdを、keywdのAND検索として利用。
4	title	「タイトル」を指定するパラメータ。
5	auth	「著者」を指定するパラメータ。
6	pub	「出版者」を指定するパラメータ。
7	year	「出版年」を指定するパラメータ。
8	isbnsn	「ISBN/ISSN」を指定するパラメータ。桁数で、ISBN、ISSNの判断を行う。
9	bibid	「書誌ID」を指定するパラメータ。bibidが指定されている場合、他の検索条件は無視される。
10	code_type	「コード種別」を指定するパラメータ。
11	code	「コード」を指定するパラメータ。
12	cls	「分類」を指定するパラメータ。
14	sortkey	「ソート」を指定するパラメータ。
15	listcnt	「レコード取得件数」を指定するパラメータ。
16	sh	「件名」を指定するパラメータ。
17	cntry	「出版国コード」を指定するパラメータ。
18	lang	「言語コード」を指定するパラメータ。
19	ncid	「NACSIS書誌ID」を指定するパラメータ。
27	startpos	「レコード取得開始位置」を指定するパラメータ。未設定もしくはゼロ以下の場合は1。

RSSレスポンス仕様

No.	第1階層	第3階層	第4階層	第5階層	属性	必須	内容	備考
1	xml					必須	XML文書であることを宣言
2	rdf:RDF					必須	文書のルート要素	xml:lang属性には返却する言語を記述する。xml:lang以外の属性は以下の文字列を記述する。

					xmlns			xmlns="http://purl.org/rss/1.0/"
					xmlns:rdf			xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
					xmlns:rdfs			xmlns:rdfs="http://www.w3.org/2000/01/rdf-schema#"
					xxmlns:dc			xmlns:dc="http://purl.org/dc/elements/1.1/"
					xmlns:prism			xmlns:prism="http://prismstandard.org/namespaces/basic/2.0/"
					xmlns:opensearch			xmlns:opensearch="http://a9.com/-/spec/opensearch/1.1/"
					xml:lang			xml:lang=”ja”>
3					rdf:about		リクエストされたURI	クエリをURLエンコードし、「変数名=値」形式で出力。「&」で連結する。
4		title					タイトル	「webOPAC Books OpenSearch -」にクエリを連結したもの。
								webOPAC Books OpenSearch - 検索1+検索2
5		description					タイトル	titleと同じ内容
6		link					リクエストされたURI
7		dc:date					検索が行われた日時	W3CDTF表記
8		opensearch:totalResults					検索結果総数
9		opensearch:startIndex					開始番号	検索結果のうち、何件目のデータから記述しているかを表示する
10		opensearch:itemsPerPage					件数	レスポンスに何件の検索結果が含まれているかを表示する
11		items
12			rdf:Seq
13				rdf:li	rdf:resource		パーマリンク	レスポンスに含まれる図書・雑誌へのパーマリンクを列挙
14					rdf:about		図書・雑誌情報	rdf:aboutにはパーマリンクを記述。

15		title					タイトル
16		link					パーマリンク	書誌詳細ページのURL
								http://library.affrc.go.jp/api/xx12345678
17		rdfs:seeAlso			rdf:resource		ｒdfへのurl
18		dc:creator					著者名	複数ある場合は列挙する
19		dc:publisher					出版者
20		prism:publicationDate					出版年
21		dc:date					出版年	prism:publicationDateと同じ内容

ATOMレスポンス仕様

No.	第1階層	第3階層	第4階層	属性	必須	内容	備考
1	xml				必須	文書がXMLであることを宣言
2	feed				必須	文書のルート要素	xml:lang属性には返却する言語を記述する。xml:lang以外の属性は以下の文字列を記述する。

				xmlns			xmlns="http://www.w3.org/2005/Atom"
				xmlns:dc			xmlns:dc="http://purl.org/dc/elements/1.1/"
				xmlns:prism			xmlns:prism="http://prismstandard.org/namespaces/basic/2.0/"
				xmlns:opensearch			xmlns:opensearch="http://a9.com/-/spec/opensearch/1.1/"
				xml:lang			xml:lang="ja">
3						フィードのタイトル	「webOPAC Books OpenSearch - 」に検索語を連結したもの。
							webOPAC Books OpenSearch - 検索1+検索2
4				href			同等内容の検索をHTMLで行う場合のURL
5				ref			固定値(self)
6				type			固定値（application/atom+xml）
7				href		クエリのURI
8						クエリのURI	link要素と同じ
9						検索が行われた日時	W3CDTF表記
10						検索結果総数
11						開始番号	検索結果のうち、何件目のデータから記述しているかを表示する
12						件数	レスポンスに何件の検索結果が含まれているかを表示する
13						検索結果の図書・雑誌情報を格納するコンテナ
14		title				タイトル
15		link		href		書誌URI	パーマリンクを表示

16		link		ref			固定値(alternate)
17				type			固定値（application/rdf+xml）
18				href		RDFのURI	RDFのURIを表示
							href="http://library.affrc.go.jp/api/XX12345678.rdf"
19		id				書誌URI	パーマリンクを表示
							http://library.affrc.go.jp/api/XX12345678
20		author					複数ある場合は列挙する
21			name			著者名
22		dc:publisher				出版者
23		prism:publicationDate				出版年月日
24		updated				出版年月日	prism:publicationDateと同じ内容

農林水産省農林水産研究情報総合センター
〒305-8601 茨城県つくば市観音台2-1-9
TEL: 029-838-7316　email:ref-cc(at)ml.affrc.go.jp　※(at)は@に置き換えてください。