Help - Metadata and API - OpenSearch - CiNii Books OpenSearch for Authors
Query Specification
CiNii Books OpenSearch for Authors query is as follows.
http://ci.nii.ac.jp/books/opensearch/author?(parameter=value)& (parameter=value)&…&(parameter=value)
Each parameter that comprises the query is as follows.
Parameters other than this table is disregarded.
| No. | Item Name | Parameter Name | Availability of Boolean expression | Remarks | |
|---|---|---|---|---|---|
| 1 | Author Name | name | Possible(AND) | Partial match or exact match of Author Name ID. Required | |
| 2 | Output format | format | Impossible | atom:ATOM format (default), rss: RSS format, html:HTML format | |
| 3 | Sort Order | sortorder | Impossible | 1: Sorts by relevance in descending order(default), 2: Sorts by name in ascending order of character code (A to Z), 3: Sorts by name in descending order of character code (Z to A), 4: Sorts by number of books with the lowest number at the top, 5: Sorts by number of books with the highest number at the top | |
| 4 | Page Number | p | Impossible | The first page is 1. | |
| 5 | Number of outcome per one page | count | Impossible | Default is 200 | |
| 6 | Application ID | appid | Impossible | Required | |
Between AND, OR, NOT and words, blank is required. When you put words without operator, a default relation (operator written with parenthesis in the table) is used.
Response Specification
You can specify the format of a response from RSS, Atom and HTML by query.
- RSS1.0 Response Format Specification
No. Tag name Required Content Remarks First level Second level Third level Fourth level Fifth level Attribute 1 xml Required Declare as XML document <?xml version="1.0" encoding="utf-8" ?> 2 rdf:RDF Required Document route element Language code of the response will appear at xml:lang attribute. Other attributes are as follows. <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 Requested URI Encoded query as "parameter=value" and connect by "&". 4 title Title Query will come after "CiNii Books Author-". <title>CiNii Books Author - search engine order</title> 5 description The same as title 6 link Requested URI (Appid is removed from a parameter.) 7 dc:date Date when search was executed W3CDTF format 8 opensearch:totalResults Total search results 9 opensearch:startIndex Start number Indicates from which record number among the search results the data is being described. 10 opensearch:itemsPerPage Results per page Indicates how many search results are included in the response. 11 items 12 rdf:Seq 13 rdf:li rdf:resource Permalink Lists the permalink to the author(s) included in the response. 14 item rdf:about Author information Describe the permalink with rdf:about. <item rdf:about="http://ci.nii.ac.jp/author/XX12345678"> 15 title Author name 16 link Permalink 17 rdfs:seeAlso rdf:resource URL of the RDF <rdfs:seeAlso rdf:resource="http://ci.nii.ac.jp/author/XX12345678.rdf" /> 18 description Author Transcription 19 dc:date Date of update Date when search performed.
- Atom1.0 Response Format Specification
No. Tag name Required Content Remarks First level Second level Third level Fourth level Attribute 1 xml Required Declare as XML document <?xml version="1.0"encoding="UTF-8" ?> 2 feed Required Document route element Language code of the response will appear at xml:lang attribute. Other attributes are as follows. <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 Feed title Query will come after "CiNii Books OpenSearch -" <title>CiNii Books OpenSearch - interaction+大向</title> 4 link href URL in the case of searching equivalent contents with HTML. 5 link ref Fixed value(self) 6 type Fixed value(application/atom+xml) 7 href Query URI Encoded query as "parameter=value" and connect by "&". 8 id Query URI Same as the link element. 9 updated Date when search was executed W3CDTF format 10 opensearch:totalResults Total search results 11 opensearch:startIndex Start number Indicates from which record number among the search results the data is being described. 12 opensearch:itemsPerPage Results per page Indicates how many search results are included in the response. 13 entry Container that stores information on author search results. 14 title Author name 15 link href Author's URI Permalink of the author.
<link href="http://ci.nii.ac.jp/author/XX12345678"/>16 link ref Fixed value(self) 17 type Fixed value(application/atom+xml) 18 href RDF's URI Displays RDF's URI. (The parameter of appid isremoved.)
href="http://ci.nii.ac.jp/author/XX12345678.rdf"19 id Author's URI Permalink of the author.
<id>http://ci.nii.ac.jp/author/XX12345678</id>20 content Author Transcription 21 type Fixed value(text) 22 updated Date of update Date when search performed