CiNii Dissertations - メタデータ・API - CiNii Dissertations 博士論文検索のOpenSearch

目次

 

クエリ仕様

CiNii Dissertations博士論文書誌検索のOpenSearchクエリは以下の形式です。
https://ci.nii.ac.jp/d/search?(パラメータ=値)& (パラメータ=値)&…&(パラメータ=値)です。

クエリを構成する各パラメータは以下のとおりです。これ以外のパラメータの記述は無視します。

No. 項目名 パラメータ名 論理式の記述可否 備考
1 フリーワード q 可（AND） 部分一致テキスト検索
2 タイトル title 可（AND） 部分一致テキスト検索
3 抄録・目次・注記 description 可（AND） 部分一致テキスト検索
4 著者名 author 可（AND） 部分一致テキスト検索
5 学位授与大学名 grantor 可（AND） 部分一致テキスト検索/パラメータ名：junii2由来
6 学位授与大学ID grantorid 可（OR） 完全一致/パラメータ名：junii2由来
7 学位授与番号 grantid 可（OR） 完全一致/パラメータ名：junii2由来
8 取得学位名 degreename 可（AND） 部分一致テキスト検索/パラメータ名：junii2由来
9 学位授与年（開始） year_from 不可 西暦年。どちらか片方だけの指定も可能です。（その場合でも学位授与年不明の書誌は検索対象外となります）
10 学位授与年（終了） year_to 不可
11 本文フルテキスト fulltext 可（AND） 部分一致テキスト検索
12 検索対象の範囲 range 不可 0:すべて（デフォルト）、1:本文あり
13 出力フォーマット format 不可 html:HTML形式（デフォルト）、rss:RSS1.0形式、atom:ATOM、json:JSON-LD形式
14 ソート順 sortorder 不可 1:学位授与年:新しい順（デフォルト）、2:学位授与年:古い順、3:タイトル:五十音順、4:タイトル:五十音逆順、5:関連度順
15 取得する検索結果一覧のページ番号 p 不可 最初のページを1とします。
16 1ページあたりの結果数 count 不可 デフォルト20
17 アプリケーションID appid 不可 必須です。
  • 論理式の記述が可能な項目においては、大文字のAND,OR,NOT演算子及び括弧　(,) を使って条件を組み立てられます。
  • AND,OR,NOTとワードの間には空白が必要です。演算子を指定せずに列挙した場合はデフォルトの演算子（表中で括弧書きされた演算子）が使用されます。
 

レスポンス仕様

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

レスポンスの際のhttpヘッダに「Access-Control-Allow-Origin: *」を指定していますので、クロスドメイン間での非同期通信をご利用いただけます。

 

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

No. タグ名 必須 繰り返し 内容 備考
第1階層 第2階層 第3階層 第4階層 第5階層 属性
1 xml           必須   XML文書であることを宣言 <?xml version="1.0" encoding="utf-8"?>
2 rdf:RDF           必須   文書のルート要素
3 xmlns XML名前空間定義 xmlns="http://purl.org/rss/1.0/"
4 xmlns:rdf xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
5 xmlns:rdfs xmlns:rdfs="http://www.w3.org/2000/01/rdf-schema#"
6 xxmlns:dc xmlns:dc="http://purl.org/dc/elements/1.1/"
7 xmlns:ndl xmlns:ndl="http://ndl.go.jp/dcndl/terms"
8 xmlns:opensearch xmlns:opensearch="http://a9.com/-/spec/opensearch/1.1/"
9   channel         必須      
10           rdf:about 必須   リクエストされたURI この検索リクエストのURI。クエリをURLエンコードし、「変数名=値」形式で出力。「&」で連結する。パラメータからappidは取り除かれる。
<channel rdf:about="http://ci.nii.ac.jp/d/search?q=%E5%A4%A7%E5%90%91%E4%B8%80%E8%BC%9D&advanced=false&count=20&format=rss&range=0&sortorder=1">
11     title       必須   タイトル 「CiNii Dissertations - 」 に検索語を連結したもの。
12     description       必須   タイトル titleと同じ内容
13     link       必須   リクエストされたURI この検索リクエストのURI。クエリをURLエンコードし、「変数名=値」形式で出力。「&」で連結する。パラメータからappidは取り除かれる
14     dc:date       必須   検索が行われた日時 W3CDTF表記
15     opensearch:totalResults       必須   検索結果総数  
16     opensearch:startIndex       必須   開始番号 検索結果のうち、何件目のデータから記述しているかを表示する
17     opensearch:itemsPerPage       必須   件数 レスポンスに何件の検索結果が含まれているかを表示する
18     items       必須      
19       rdf:Seq     必須      
20         rdf:li     0..*   レスポンスに含まれる博士論文へのパーマリンクを列挙。最大でopensearch:itemsPerPageの数まで繰り返す
21           rdf:resource 必須   書誌詳細ページのURI  
22   item           0..* 検索結果の書誌情報を格納するコンテナ 最大でopensearch:itemsPerPageの数まで繰り返す
23           rdf:about 必須   書誌詳細ページのURI 書誌詳細ページのパーマリンク
例：
<item rdf:about="http://ci.nii.ac.jp/d/500000000000"/>
24     title       必須   タイトル  
25     link       必須   書誌詳細ページのURI 書誌詳細ページのパーマリンク
<link>http://ci.nii.ac.jp/d/500000000000</link>
26     rdfs:seeAlso       必須   書誌RDFに関する記述 書誌RDFのURIを表示(ただしappidのパラメータは除く）
<rdfs:seeAlso rdf:resource="http://ci.nii.ac.jp/d/500000000000.rdf" />
27           rdf:resource 必須   書誌RDFのURI  
28     dc:creator       必須   著者名  
29     dc:publisher       あれば必須 0..1 学位授与機関名  
30     ndl:degreeName       あれば必須 0..1 取得学位名  
31     ndl:dissertationNumber       あれば必須 0..1 学位授与番号  
32     dc:date       必須   学位授与年月日 W3CDTF表記
33     dc:source       あれば必須 0..* 本文リンクに関する記述 例：
<dc:source rdf:resource="http://dl.ndl.go.jp/info:ndljp/pid/3189366" dc:title="NDLデジタルコレクション"/>
34           rdf:resource あれば必須 0..1 本文公開ページのURL  
35           dc:title あれば必須 0..1 データソースの名称  
 

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

No. タグ名 必須 繰り返し 内容 備考
第1階層 第2階層 第3階層 第4階層 属性
1 xml         必須   XML文書であることを宣言 <?xml version="1.0" encoding="UTF-8"?>
2 feed         必須   文書のルート要素  
3 xmlns XML名前空間定義 xmlns="http://www.w3.org/2005/Atom"
4 xmlns:dc xmlns:dc="http://purl.org/dc/elements/1.1/"
5 xmlns:ndl xmlns:ndl="http://ndl.go.jp/dcndl/terms"
6 xmlns:opensearch xmlns:opensearch="http://a9.com/-/spec/opensearch/1.1/"
7   title       必須   フィードのタイトル 「CiNii Dissertations - 」 に検索語を連結したもの。
8   link     href 必須   検索ページのURL 同等内容の検索をHTMLで行う場合のURL
9   link     rel 必須   参照先の文書との関係 固定値(self)
10         type 必須   参照先の文書のMIMEタイプ 固定値（application/atom+xml）
11         href 必須   リクエストされたURI この検索リクエストのURI。クエリをURLエンコードし、「変数名=値」形式で出力。「&」で連結する。パラメータからappidは取り除かれる
12   id       必須   リクエストされたURI link要素と同じ
13   updated       必須   検索が行われた日時 W3CDTF表記
14   opensearch:totalResults       必須   検索結果総数  
15   opensearch:startIndex       必須   開始番号 検索結果のうち、何件目のデータから記述しているかを表示する
16   opensearch:itemsPerPage       必須   件数 レスポンスに何件の検索結果が含まれているかを表示する
17   entry         0..* 検索結果の書誌情報を格納するコンテナ 最大でopensearch:itemsPerPageの数まで繰り返す。
18     title     必須   タイトル  
19     link   href 必須   書誌詳細ページのURI 書誌詳細ページのパーマリンクを表示
<link href="http://ci.nii.ac.jp/d/500000000000"/>
20     link   rel 必須   参照先の文書との関係 固定値(alternate)
21         type 必須   参照先の文書のMIMEタイプ 固定値（application/rdf+xml）
22         href 必須   書誌RDFのURI 書誌RDFのURIを表示(ただしappidのパラメータは除く）
href="http://ci.nii.ac.jp/d/500000000000.rdf"
23     link   rel 必須   参照先の文書との関係 固定値（via）
24         href 必須   本文公開ページのURL 本文公開ページへのリンク
例：
<link rel="via" href="http://dl.ndl.go.jp/info:ndljp/pid/3189366"/>
25     id     必須   書誌詳細ページのURI 書誌詳細ページのパーマリンクを表示
<id>http://ci.nii.ac.jp/d/500000000000</id>
26     author     必須   著者に関する記述  
27       name   必須   著者名  
28     dc:publisher     あれば必須 0..1 学位授与機関名  
29     ndl:degreeName     あれば必須 0..1 取得学位名  
30     ndl:dissertationNumber     あれば必須 0..1 学位授与番号  
31     updated     必須   学位授与年月日 W3CDTF表記
 

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

No. タグ名 型 必須 内容 備考
第1階層 第2階層 第3階層 第4階層 第5階層
1 @context         オブジェクト 必須 文書のルート要素 "@context": {
"@vocab": "http://purl.org/rss/1.0/"
"rdf": "http://www.w3.org/1999/02/22-rdf-syntax-ns#",
"rdfs": "http://www.w3.org/2000/01/rdf-schema#",
"dc": "http://purl.org/dc/elements/1.1/",
"prism": "http://prismstandard.org/namespaces/basic/2.0/",
"opensearch": "http://a9.com/-/spec/opensearch/1.1/"
},
2   @vocab         必須   http://purl.org/rss/1.0/
3   rdf         必須   http://www.w3.org/1999/02/22-rdf-syntax-ns#
4   rdfs         必須   http://www.w3.org/2000/01/rdf-schema#
5   dc         必須   http://purl.org/dc/elements/1.1/
6   prism         必須   http://prismstandard.org/namespaces/basic/2.0/
7   opensearch         必須   http://a9.com/-/spec/opensearch/1.1/
8 @id           必須 リクエストされたURI この検索リクエストのURI。クエリをURLエンコードし、「変数名=値」形式で出力。パラメータからappidは取り除かれる
9 @graph         配列 必須   配列の要素数は1
10   @id         必須 リクエストされたURI この検索リクエストのURI。クエリをURLエンコードし、「変数名=値」形式で出力。パラメータからappidは取り除かれる
11   @type         必須   固定："channel"
12   title         必須 タイトル 「CiNii Dissertations OpenSearch -」にクエリを連結したもの。
13   description         必須 タイトル titleと同じ内容
14   link       オブジェクト 必須    
15     @id       必須 リクエストされたURI この検索リクエストのURI。クエリをURLエンコードし、「変数名=値」形式で出力。パラメータからappidは取り除かれる
16   dc:date         必須 検索が行われた日時 W3CDTF表記
17   opensearch:totalResults         必須 検索結果総数  
18   opensearch:startIndex         必須 開始番号 検索結果のうち、何件目のデータから記述しているかを表示する
19   opensearch:itemsPerPage         必須 件数 レスポンスに何件の検索結果が含まれているかを表示する
20   items       オブジェクト      
21     @id       必須 書誌詳細ページのURL 詳細ページのURLに「#article」を付けたもの
22     @type           固定:"item"
23     title       必須 タイトル  
24     link     オブジェクト 必須    
25       @id     必須 書誌詳細ページのURL 書誌詳細ページのパーマリンクを表示
"link": {@id:"http://ci.nii.ac.jp/d/500000000000"},
26     rdfs:seeAlso     オブジェクト 必須    
27       @id     必須 書誌JSON-LDのURI 書誌JSON-LDのURIを表示(ただしappidのパラメータは除く）
"rdfs:seeAlso":{@id:"http://ci.nii.ac.jp/d/500000000000.json"},
28     dc:creator     配列 必須    
29       @value     必須 著者名  
30     dc:publisher         学位授与機関名  
31     ndl:degreeName         取得学位名  
32     ndl:dissertationNumber         学位授与番号  
33     dc:date         学位授与年月日 W3CDTF表記
34     dc:source     配列      
35       @id     必須 本文公開ページのURL  
36       dc:title     必須 データソースの名称