ヘルプ - メタデータ・API - OpenSearch - CiNii Books 著者検索のOpenSearch
クエリ仕様
CiNii Books著者検索のOpenSearchクエリは以下の形式です。
http://ci.nii.ac.jp/books/opensearch/author?(パラメータ=値)& (パラメータ=値)&…&(パラメータ=値)です。
クエリを構成する各パラメータは以下のとおりです。
これ以外のパラメータの記述は無視します。※印のある項目から最低１つ以上の指定が必要です
| No. | 項目名 | パラメータ名 | 論理式の記述可否 | 備考 | |
|---|---|---|---|---|---|
| 1 | 著者名 | name | 可能（AND) | 部分一致テキスト検索、または著者名典拠IDの完全一致。必須です。 | |
| 2 | 出力フォーマット | format | 不能 | atom:ATOM形式（デフォルト）、rss: RSS形式、 html:HTML形式 | |
| 3 | ソート順 | sortorder | 不能 | 1:検索スコア順（デフォルト）、2:名前昇順、3:名前降順、4:収録書誌数昇順、5:収録書誌数降順 | |
| 4 | ページ番号 | p | 不能 | 最初のページを1とします。 | |
| 5 | 1ページあたりの結果数 | count | 不能 | デフォルト20 | |
| 6 | アプリケーションID | appid | 不能 | 必須です。 | |
AND,OR,NOTとワードの間には空白が必要です。演算子を指定せずに列挙した場合はデフォルトの演算子（表中で括弧書きされた演算子）が使用されます。
レスポンス仕様
クエリでレスポンスのフォーマットを、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 Books Author -」にクエリを連結したもの <title>CiNii Books Author - 検索エンジン 順位</title> 5 description titleと同じ内容 6 link リクエストされたURI （ただしパラメータからappidは取り除かれる） 7 dc:date 検索が行われた日時 W3CDTF表記 8 opensearch:totalResults 検索結果総数 9 opensearch:startIndex 開始番号 検索結果のうち、何件目のデータから記述しているかを表示する 10 opensearch:itemsPerPage 件数 レスポンスに何件の検索結果が含まれているかを表示する 11 items 12 rdf:Seq 13 rdf:li rdf:resource パーマリンク レスポンスに含まれる著者へのパーマリンクを列挙 14 item rdf:about 著者情報 rdf:aboutにはパーマリンクを記述。 <item rdf:about="http://ci.nii.ac.jp/author/XX12345678"> 15 title 著者名 16 link パーマリンク 17 rdfs:seeAlso rdf:resource rdfへのurl <rdfs:seeAlso rdf:resource="http://ci.nii.ac.jp/author/XX12345678.rdf" /> 18 description 著者名よみ 19 dc:date 更新日時 検索を実行した日時
- 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:opensearch xmlns:opensearch="http://a9.com/-/spec/opensearch/1.1/" xml:lang xml:lang=”ja”> 3 title フィードのタイトル 「CiNii Books OpenSearch - 」 に検索語を連結したもの。 <title>CiNii Books OpenSearch - インタラクション+大向</title> 4 link href 同等内容の検索をHTMLで行う場合のURL 5 link ref 固定値(self) 6 type 固定値（application/atom+xml） 7 href クエリのURI クエリをURLエンコードし、「変数名=値」形式で出力。「&」で連結する。 8 id クエリのURI link要素と同じ 9 updated 検索が行われた日時 W3CDTF表記 10 opensearch:totalResults 検索結果総数 11 opensearch:startIndex 開始番号 検索結果のうち、何件目のデータから記述しているかを表示する 12 opensearch:itemsPerPage 件数 レスポンスに何件の検索結果が含まれているかを表示する 13 entry 検索結果の著者情報を格納するコンテナ 14 title 著者名 15 link href 著者のURI パーマリンクを表示
<link href="http://ci.nii.ac.jp/author/XX12345678"/>16 link ref 固定値(self) 17 type 固定値（application/atom+xml） 18 href RDFのURI RDFのURIを表示(ただしappidのパラメータは除く）
href="http://ci.nii.ac.jp/author/XX12345678.rdf"19 id 著者のURI パーマリンクを表示
<id>http://ci.nii.ac.jp/author/XX12345678</id>20 content 著者名よみ 21 type 固定値（text） 22 updated 更新日時 検索を実行した日時