ヘルプ - メタデータ・API - OpenSearch - CiNii Articles 全文検索のOpenSearch
クエリ仕様
全文検索のOpenSearchクエリは以下の形式です。
http://ci.nii.ac.jp/opensearch/fulltext?(パラメータ=値)& (パラメータ=値)&…&(パラメータ=値)です。
※全文検索のOpenSearchは他のCiNii APIに比べて、受けられる検索数が少ないため、使用には配慮をお願いいたします。
また、事前の連絡なく弊所からアクセスを遮断させていただくことがありますのでご了承ください。
クエリを構成する各パラメータは以下のとおりです。
| No. | パラメータ | 内容 |
| 1 | q | フリーワードを指定するパラメータ（必須） |
| このパラメータはURLエンコードされている必要がある。 | ||
| 2 | count | ページあたりの検索結果件数を指定するパラメータ（任意） |
| デフォルトは20。0以下もしくは200を越える値が指定された場合、もしくは指定されない場合はデフォルト設定とみなす。（200：論文検索結果画面の最大表示件数） | ||
| 3 | lang | 検索結果の言語を指定するパラメータ（任意） |
| デフォルトはja。日本語(ja)もしくは英語(en)を指定。ja、en以外の文字列、または指定がない場合はデフォルト設定とみなす。 | ||
| 4 | start | 取得する検索結果一覧の開始番号（任意） |
| デフォルトは0。0以下もしくは検索件数を越える値が指定された場合はデフォルト設定とみなす。 | ||
| 5 | format | レスポンスの形式を指定するパラメータ（任意） |
| デフォルトはxhtml（通常の検索一覧画面）。rss・atomを指定できる。rss・atomのフォーマットは後述。 | ||
| 6 | sortorder | ソート条件を指定する。デフォルトは1。 |
| 出版年:新しい順→「1」／出版年：古い順→「2」 | ||
| 論文名：降順→「3」／論文名：昇順→「4」 | ||
| 刊行物：降順→「5」／刊行物：昇順→「6」 | ||
| 被引用文献数：多い順→「7」／検索スコア：高い順→「8」 |
レスポンス仕様
クエリでレスポンスのフォーマットを、RSS, Atom, HTMLから選択できます。
- 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以外の属性は以下の文字列を記述する。 <rdf:RDF 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 channel rdf:about リクエストされたURI クエリをURLエンコードし、「変数名=値」形式で出力。「&」で連結する。 4 title タイトル 「CiNii Full text OpenSearch -」にクエリを連結したもの。 <title>CiNii Full text OpenSearch - 検索エンジン 順位</title> 5 link リクエストされたURI 6 dc:date 検索が行われた日時 W3CDTF表記 7 opensearch:totalResults 検索結果総数 8 opensearch:startIndex 開始番号 検索結果のうち、何件目のデータから記述しているかを表示する 9 opensearch:itemsPerPage 件数 レスポンスに何件の検索結果が含まれているかを表示する 10 items 11 rdf:Seq 12 rdf:li rdf:resource パーマリンク レスポンスに含まれる論文へのパーマリンクを列挙 13 item rdf:about 論文情報 rdf:aboutにはパーマリンクを記述。 <item rdf:about="http://ci.nii.ac.jp/naid/1234567890"> 14 title 論文名 15 link パーマリンク 16 rdfs:seeAlso rdf:resource ｒdfへのurl <rdfs:seeAlso rdf:resource="http://ci.nii.ac.jp/naid/1234567890/rdf" /> 17 dc:creator 著者名 複数ある場合は列挙する 18 dc:publisher 出版者 19 prism:publicationName 刊行物名 20 prism:issn ISSN 21 prism:volume 巻 22 prism:number 号 23 prism:startingPage 開始ページ 24 prism:endingPage 終了ページ 25 prism:pageRange ページ 26 prism:publicationDate 出版年月日 W3CDTF表記 27 description 抄録 表示する内容は未ログイン状態のものとする 28 dc:date 出版年月日 prism:publicationDateと同じ内容
- Atom1.0 レスポンスフォーマット仕様
No. タグ名 必須 内容 備考 第1階層 第2階層 第3階層 第4階層 属性 1 xml 必須 文書がXMLであることを宣言 <?xml version="1.0"encoding="UTF-8" ?> 2 feed 必須 文書のルート要素 xml:lang属性には返却する言語を記述する。xml:lang以外の属性は以下の文字列を記述する。 <feed 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 title フィードのタイトル 「CiNii Full text OpenSearch - 」 に検索語を連結したもの。 <title>CiNii Full text OpenSearch - インタラクション+大向</title> 4 link href= クエリのURI クエリをURLエンコードし、「変数名=値」形式で出力。「&」で連結する。 5 id クエリのURI link要素と同じ 6 updated 検索が行われた日時 W3CDTF表記 7 opensearch:totalResults 検索結果総数 8 opensearch:startIndex 開始番号 検索結果のうち、何件目のデータから記述しているかを表示する 9 opensearch:itemsPerPage 件数 レスポンスに何件の検索結果が含まれているかを表示する 10 entry 検索結果の論文情報を格納するコンテナ 11 title 論文名 12 link href 書誌URI パーマリンクを表示 13 link href RDFのURI RDFのURIを表示 14 id 書誌URI パーマリンクを表示 15 author 複数ある場合は列挙する 16 name 著者名 17 dc:publisher 出版者 18 prism:publicationName 刊行物名 19 prism:issn ISSN 20 prism:volume 巻 21 prism:number 号 22 prism:startingPage 開始ページ 23 prism:endingPage 終了ページ 24 prism:pagePange ページ 25 prism:publicationDate 出版年月日 W3CDTF表記 26 content 論文の抄録 表示する内容は未ログイン状態のものとする <content type="text"></content> 27 updated 出版年月日 prism:publicationDateと同じ内容