CiNii Research 所蔵検索のOpenSearch

目次

 

クエリ仕様

CiNii Researchの所蔵検索のOpenSearchクエリは以下の形式です。
https://cir.nii.ac.jp/opensearch/holder?(パラメータ=値)& (パラメータ=値)&…&(パラメータ=値)です。

No. 項目名 パラメータ名 論理式の記述可否 備考
1 NCID ncid 不可 完全一致、必須です。
2 参加組織：ILL参加 ill 不可 A:参加、 N:不参加
3 参加組織：ILLステータス ill_stat 不可 A:可能、 N:不可能
4 参加組織：複写サービス ill_copys 不可 A:可能、C:他の窓口で受け付け、 N:不可能
5 参加組織：貸借サービス ill_loans 不可 A:可能、C: 他の窓口で受け付け、 N:不可能
6 参加組織：FAXサービス ill_faxs 不可 A:可能、C:条件つきで可能、 N:不可能
7 参加組織：日英ILL参加 ill_oclc 不可 A:参加、 N:不参加
8 参加組織：日韓ILL参加 ill_keris 不可 A:参加、 N:不参加
9 参加組織：料金相殺参加 ill_offset 不可 A:参加、 N:不参加
10 参加組織：参加組織番号 fano 不可 完全一致
11 雑誌所蔵：年 year 不可 範囲指定不可。
該当の書誌が図書の場合は無視します。
12 雑誌所蔵：巻 vol 不可 範囲指定不可。
該当の書誌が図書の場合は無視します。
13 雑誌所蔵：号 issue 不可 範囲指定不可。
該当の書誌が図書の場合は無視します。
14 雑誌所蔵：継続 cont 不可 0:非継続、1:継続
該当の書誌が図書の場合は無視します。
15 出力フォーマット format 不可 atom:ATOM形式(デフォルト)
rss: RSS形式
json: JSON-LD形式
16 アプリケーションID appid 不可 必須です。
 

レスポンス仕様

クエリでレスポンスのフォーマットを、RSS, Atom, JSON-LDから選択できます。

 

RSS1.0 レスポンスフォーマット仕様

No. タグ名 必須 内容 備考
第1階層 第2階層 第3階層 第4階層 第5階層 属性
1 xml 必須 XML文書であることを宣言 <?xml version="1.0" encoding="utf-8" ?>
2 rdf:RDF 必須 文書のルート要素 xml:lang属性には返却する言語を記述する。xml:lang以外の属性は以下の文字列を記述する。
3 <rdf:RDF
4 xmlns xmlns="http://purl.org/rss/1.0/"
5 xmlns:rdf xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
6 xmlns:rdfs xmlns:rdfs="http://www.w3.org/2000/01/rdf-schema#"
7 xmlns:dc xmlns:dc="http://purl.org/dc/elements/1.1/"
8 xmlns:opensearch xmlns:opensearch="http://a9.com/-/spec/opensearch/1.1/"
9 xmlns:cir xmlns:cir="https://cir.nii.ac.jp/schema/1.0/"
10 xml:lang xml:lang="ja">
11 channel rdf:about 必須 リクエストされたURI この検索リクエストのURI。クエリをURLエンコードし、「変数名=値」形式で出力。「&amp;」で連結する。パラメータからappidは取り除かれる
12 title 必須 タイトル 「CiNii Research Holder - 」にクエリを連結したもの。
例：
<title>CiNii Research Holder - ○○○○○</title>
13 description 必須 タイトル titleと同じ内容
14 link 必須 リクエストされたURI この検索リクエストのURI。クエリをURLエンコードし、「変数名=値」形式で出力。「&amp;」で連結する。パラメータからappidは取り除かれる
15 dc:date 必須 検索が行われた日時 W3CDTF表記
16 opensearch:totalResults 必須 検索結果総数
17 items 必須
18 rdf:Seq 必須
19 rdf:li rdf:resource 必須 図書館詳細ページのURI レスポンスに含まれる図書館詳細情報へのパーマリンクを列挙。
20 item rdf:about 必須 図書館情報 rdf:aboutにはパーマリンクを記述。
<item rdf:about="https://ci.nii.ac.jp/library/FA123456">
21 title 必須 図書館名
22 link 必須 図書館詳細ページのURI 図書館詳細ページのパーマリンクを表示
<link>https://ci.nii.ac.jp/library/FA123456</link>
23 rdfs:seeAlso rdf:resource 必須 図書館詳細情報RDFのURI 図書館詳細情報RDFのURIを表示
<rdfs:seeAlso rdf:resource="https://ci.nii.ac.jp/library/FA123456.rdf" />
24 dc:identifier 必須 識別子
25 rdf:datatype 必須 識別子のタイプ "cir:FANO"
26 (値) 必須 識別子の値 図書館IDを出力する
27 dc:date 必須 検索が行われた日時
 

Atom1.0 レスポンスフォーマット仕様

No. タグ名 必須 内容 備考
第1階層 第2階層 第3階層 第4階層 第5階層 属性
1 xml 必須 XML文書であることを宣言 <?xml version="1.0" encoding="utf-8" ?>
2 feed 必須 文書のルート要素 xml:lang属性には返却する言語を記述する。xml:lang以外の属性は以下の文字列を記述する。
3 <feed
4 xmlns xmlns="http://www.w3.org/2005/Atom"
5 xmlns:rdf xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
6 xmlns:dc xmlns:dc="http://purl.org/dc/elements/1.1/"
7 xmlns:opensearch xmlns:opensearch="http://a9.com/-/spec/opensearch/1.1/"
8 xmlns:cir xmlns:cir="https://cir.nii.ac.jp/schema/1.0/"
9 xml:lang xml:lang="ja">
10 title 必須 フィードのタイトル 「CiNii Research Holder - 」にクエリを連結したもの。
例：
<title>CiNii Research Holder - ○○○○○</title>
11 link rel 必須 参照先の文書との関係 固定値(self)
12 type 必須 参照先の文書のMIMEタイプ 固定値(application/atom+xml)
13 href 必須 リクエストされたURI この検索リクエストのURI。クエリをURLエンコードし、「変数名=値」形式で出力。「&amp;」で連結する。パラメータからappidは取り除かれる
14 id 必須 リクエストされたURI link要素と同じ
15 updated 必須 検索が行われた日時 W3CDTF表記
16 opensearch:totalResults 必須 検索結果総数
17 entry 検索結果の図書館情報を格納するコンテナ
18 title 必須 図書館名
19 link href 必須 図書館詳細ページのURI 図書館詳細ページのパーマリンクを表示
<link href="https://ci.nii.ac.jp/library/FA123456"/>
20 link rel 必須 参照先の文書との関係 固定値(alternate)
21 type 必須 参照先の文書のMIMEタイプ 固定値(application/rdf+xml)
22 href 必須 図書館詳細情報RDFのURI 図書館詳細情報RDFのURIを表示
href="https://ci.nii.ac.jp/library/FA123456.rdf"
23 id 必須 図書館詳細ページのURI 図書館詳細ページのパーマリンクを表示
<id>https://ci.nii.ac.jp/library/FA123456</id>
24 dc:identifier 必須 識別子
25 rdf:datatype 必須 識別子のタイプ "cir:FANO"
26 (値) 必須 識別子の値 図書館IDを出力する
27 updated 必須 検索が行われた日時
 

JSON-LD レスポンスフォーマット仕様

No. タグ名 型 必須 内容 備考
第1階層 第2階層 第3階層 第4階層 第5階層
1 @context オブジェクト 必須 文書のルート要素 "@context": {
"dc": "http://purl.org/dc/elements/1.1/",
"rdf": "http://www.w3.org/1999/02/22-rdf-syntax-ns#",
"opensearch": "http://a9.com/-/spec/opensearch/1.1/",
"cir":"https://cir.nii.ac.jp/schema/1.0/"
"rdfs": "http://www.w3.org/2000/01/rdf-schema#",
"@vocab": "http://purl.org/rss/1.0/"
},
2 dc 必須 http://purl.org/dc/elements/1.1/
3 rdf 必須 http://www.w3.org/1999/02/22-rdf-syntax-ns#
4 opensearch 必須 http://a9.com/-/spec/opensearch/1.1/
5 cir 必須 https://cir.nii.ac.jp/schema/1.0/
6 rdfs 必須 http://www.w3.org/2000/01/rdf-schema#
7 @vocab 必須 http://purl.org/rss/1.0/
8 @id 必須 リクエストされたURI この検索リクエストのURI。クエリをURLエンコードし、「変数名=値」形式で出力。パラメータからappidは取り除かれる
9 @graph 配列 必須 配列の要素数は1
10 @id 必須 リクエストされたURI この検索リクエストのURI。クエリをURLエンコードし、「変数名=値」形式で出力。パラメータからappidは取り除かれる
11 @type 必須 固定："channel"
12 title 必須 タイトル 「CiNii Research Holder - 」にクエリを連結したもの。
例：
"title":"CiNii Research Holder - ○○○○○",
13 description 必須 タイトル titleと同じ内容
14 link オブジェクト 必須
15 @id 必須 リクエストされたURI この検索リクエストのURI。クエリをURLエンコードし、「変数名=値」形式で出力。パラメータからappidは取り除かれる
16 dc:date 必須 検索が行われた日時 W3CDTF表記
17 opensearch:totalResults 必須 検索結果総数
18 items 配列
19 @id 必須 図書館詳細ページのURI 図書館詳細ページのパーマリンクを表示
"@id":"https://ci.nii.ac.jp/library/FA123456",
20 @type 必須 固定:"item"
21 title 必須 図書館名
22 link オブジェクト 必須
23 @id 必須 図書館詳細ページのURI 図書館詳細ページのURIのパーマリンクを表示
"link": {"@id":"https://ci.nii.ac.jp/library/FA123456"},
24 rdfs:seeAlso オブジェクト 必須
25 @id 必須 図書館詳細情報JSON-LDのURI 図書館詳細情報JSON-LDのURIを表示
"rdfs:seeAlso":{"@id":"https://ci.nii.ac.jp/library/FA123456.json"},
26 dc:identifier 必須 識別子
27 @type 必須 識別子のタイプ "cir:FANO"
28 @value 必須 識別子の値 図書館IDを出力する
29 dc:date 必須 検索が行われた日時 W3CDTF表記
 

改訂履歴

改訂履歴をご確認いただけます。

2026年3月30日作成

所蔵検索のOpensearchを追加