Help - Metadata and API - OpenSearch - CiNii Books OpenSearch for Holdings
Query Specification
CiNii Books OpenSearch for Holding Libraries query is as follows.
http://ci.nii.ac.jp/books/opensearch/holder?(parameter=value)& (parameter=value)&…&(parameter=value)
Each parameter that comprises the query is as follows.
Parameters other than this table are disregarded.
| No. | Item Name | Parameter Name | Availability of Boolean expression | Remarks | |
|---|---|---|---|---|---|
| 1 | NCID | ncid | Impossible | Exact match, Required | |
| 2 | Library: ILL Membership | ill | Impossible | A: Participant, N: Not Participant | |
| 3 | Library: ILL Status | ill_stat | Impossible | A: Available, N: Not available | |
| 4 | Library: Copy Service Status | ill_copys | Impossible | A: Available, C: Require at the other library, N: Not available | |
| 5 | Library: Loan Service Status | ill_loans | Impossible | A: Available, C: Require at the other library, N: Not available | |
| 6 | Library: FAX Service Status | ill_faxs | Impossible | A: Available, C: Available with conditions, N: Not available | |
| 7 | Library: Membership of Japan and US ILL | ill_oclc | Impossible | A: Participant, N: Not Participant | |
| 8 | Library: Membership of Japan and Korea ILL | ill_keris | Impossible | A: Participant, N: Not Participant | |
| 9 | Library: Membership of ILL Offset | ill_offset | Impossible | A: Participant, N: Not Participant | |
| 10 | Library: Library ID | fano | Impossible | Exact match | |
| 11 | Journal Holding: Year | year | Impossible | Range specification is disapprove. | These parameters will be ignored if the record you searched is book. |
| 12 | Journal Holding: Volume | vol | Impossible | Range specification is disapprove. | |
| 13 | Journal Holding: Number | issue | Impossible | Range specification is disapprove | |
| 14 | Journal Holding: Continuing | cont | Impossible | 0: Not continuing, 1: Continuing | |
| 15 | Output format | format | Impossible | atom:ATOM format (default), rss: RSS format | |
| 16 | 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.
- RSS Response Format Specification
No. Tag name Required Content Remarks First level Second level Third level Fourth level Fifth level 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: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 Holder-". <title>CiNii Books Holder- ○○○○○</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 library(libraries) included in the response. 14 item rdf:about Library information Describe the permalink with rdf:about. <item rdf:about="http://ci.nii.ac.jp/library/FA123456"> 15 title Library Name 16 link Permalink 17 rdfs:seeAlso rdf:resource URL of the RDF <rdfs:seeAlso rdf:resource="http://ci.nii.ac.jp/library/FA123456.rdf" /> 18 dc:date Date when search was executed
- 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 documen <?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 Holder-". <title>CiNii Books Holder- ○○○○○</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 library search results 14 title Library Name 15 link href Library's URI Permalink of the library.
<link href="http://ci.nii.ac.jp/library/FA123456"/>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 is removed.)
href="http://ci.nii.ac.jp/library/FA123456.rdf"19 id Library's URI Permalink of the library.
<id>http://ci.nii.ac.jp/library/FA123456</id>20 updated Date when search was executed