ndlsearch_api_ap3_20180322_en.pdf

Type: Document | Status: ready
← All sources

Appendix 3,
Application Programming Interface (API) Specifications 32 / 76

3.OpenSearch

(1) Request example http://iss.ndl.go.jp/api/opensearch?title=%e3%81%93%e3%81%93%e3%82%8d&creator=% e5%a4%8f%e7%9b%ae%e6%bc%b1%e7%9f%b3&from=2011&until=2013

(Example of search by "title=こころ& creator=夏目漱石& from=2011&until=2013")

(2) Examples of returned data

<?xml version="1.0" encoding="UTF-8"?>

<rss xmlns:dcterms="http://purl.org/dc/terms/" xmlns:rdf="http://www.w3.org/1999/02/22-rdf-s yntax-ns#" xmlns:dcndl="http://ndl.go.jp/dcndl/terms/" version="2.0" xmlns:dc="http://purl.o rg/dc/elements/1.1/" xmlns:openSearch="http://a9.com/-/spec/opensearchrss/1.0/" xmlns:xsi="h ttp://www.w3.org/2001/XMLSchema-instance" xmlns:rdfs="http://www.w3.org/2000/01/rdf-schema#" xmlns:dcmitype="http://purl.org/dc/dcmitype/"> <channel> <title>2011 2013 こころ 夏目漱石 - 国立国会図書館サーチ OpenSearch</title> <link>http://iss.ndl.go.jp/api/opensearch?creator=%E5%A4%8F%E7%9B%AE%E6%BC%B1%E7%9F%B3&a mp;title=%E3%81%93%E3%81%93%E3%82%8D&from=2011&until=2013</link> <description>Search results for title=こころ from=2011 creator=夏目漱石 until=2013 </des cription> <language>ja</language> openSearch:totalResults3</openSearch:totalResults> openSearch:startIndex1</openSearch:startIndex> openSearch:itemsPerPage</openSearch:itemsPerPage> <item> <title>Anima e cuore</title> <link>http://iss.ndl.go.jp/books/R100000002-I024682509-00</link> <description>

<![CDATA[<p>Youcanprint Self-Publishing,9788891108111</p> <ul><li>タイトル： Anima e cuore</li> <li>責任表示： Natsume Sōseki,traduzione di Antonio Vacca,</li> </ul>]]> </description> <author>Natsume Sōseki,traduzione di Antonio Vacca,</author> <category>本</category> <guid isPermaLink="true">http://iss.ndl.go.jp/books/R100000002-I024682509-00</guid> <pubDate>Tue, 03 Sep 2013 09:00:00 +0900</pubDate> <dc:title>Anima e cuore</dc:title> <dc:creator>Natsume Sōseki</dc:creator> <dc:creator>traduzione di Antonio Vacca</dc:creator> <dc:publisher>Youcanprint Self-Publishing</dc:publisher> <dcterms:issued xsi:type="dcterms:W3CDTF">2013</dcterms:issued> <dc:identifier xsi:type="dcndl:ISBN">9788891108111</dc:identifier> <dc:subject xsi:type="dcndl:NDLC">KH884</dc:subject> <rdfs:seeAlso rdf:resource="http://id.ndl.go.jp/bib/024682509"/> </item> <item> <title>Koprnenje</title> <link>http://iss.ndl.go.jp/books/R100000002-I024429124-00</link> <description> <![CDATA[<p>Sanje,9789612740412</p> <ul><li>タイトル： Koprnenje</li> <li>責任表示： Natsume Sōseki,iz japonščine prevedel Iztok Ilc,</li> <li>シリーズ名： Zbirka Sanje roman</li>

Appendix 3,
Application Programming Interface (API) Specifications 33 / 76

</ul>]]> </description> <author>Natsume Sōseki,iz japonščine prevedel Iztok Ilc,</author> <category>本</category> <guid isPermaLink="true">http://iss.ndl.go.jp/books/R100000002-I024429124-00</guid> <pubDate>Mon, 27 May 2013 09:00:00 +0900</pubDate> <dc:title>Koprnenje</dc:title> <dc:creator>Natsume Sōseki</dc:creator> <dc:creator>iz japonščine prevedel Iztok Ilc</dc:creator> <dcndl:edition>Prvi natis</dcndl:edition> <dcndl:seriesTitle>Zbirka Sanje roman</dcndl:seriesTitle> <dc:publisher>Sanje</dc:publisher> <dcterms:issued xsi:type="dcterms:W3CDTF">2012</dcterms:issued> <dc:identifier xsi:type="dcndl:ISBN">9789612740412</dc:identifier> <dc:identifier xsi:type="dcndl:ISBN">9612740410</dc:identifier> <dc:subject>Japonska--1912-1945--V leposlovju</dc:subject> <dc:subject xsi:type="dcndl:NDLC">KH884</dc:subject> <dc:subject xsi:type="dcterms:UDC">821.51/.71</dc:subject> <dcterms:description>Translation of: Kokoro : Sensei no isho</dcterms:description> <rdfs:seeAlso rdf:resource="http://id.ndl.go.jp/bib/024429124"/> </item> <item> <title>読んでおきたいベスト集!夏目漱石</title> <link>http://iss.ndl.go.jp/books/R100000002-I000011223692-00</link> <description> <![CDATA[<p>宝島社,9784796685139</p> <ul><li>タイトル： 読んでおきたいベスト集!夏目漱石</li> <li>タイトル（読み）： ヨンデオキタイ ベストシュウ ナツメ ソウセキ</li> <li>責任表示： 夏目漱石 [著],別冊宝島編集部 編,</li> <li>シリーズ名： 宝島社文庫</li> <li>シリーズ名（読み）： タカラジマシャ ブンコ</li> <li>NDC(9)： 913.6</li> </ul>]]> </description> <author>夏目漱石 [著],別冊宝島編集部 編,</author> <category>本</category> <guid isPermaLink="true">http://iss.ndl.go.jp/books/R100000002-I000011223692-00</guid> <pubDate>Tue, 19 Jul 2011 09:00:00 +0900</pubDate> <dc:title>読んでおきたいベスト集!夏目漱石 </dc:title> <dcndl:titleTranscription>ヨンデオキタイ ベストシュウ ナツメ ソウセキ</dcndl:titleTran scription> <dc:creator>夏目漱石 [著]</dc:creator> <dc:creator>別冊宝島編集部 編</dc:creator> <dcndl:seriesTitle>宝島社文庫</dcndl:seriesTitle> <dcndl:seriesTitleTranscription>タカラジマシャ ブンコ</dcndl:seriesTitleTranscription> <dc:publisher>宝島社</ dc:publisher> <dcterms:issued xsi:type="dcterms:W3CDTF">2011</dcterms:issued> <dc:identifier xsi:type="dcndl:ISBN">9784796685139</dc:identifier> <dc:identifier xsi:type="dcndl:JPNO">21951794</dc:identifier> <dc:subject xsi:type="dcndl:NDLC">KH426</dc:subject> <dc:subject xsi:type="dcndl:NDC9">913.6</dc:subject> <rdfs:seeAlso rdf:resource="http://id.ndl.go.jp/bib/000011223692"/> </item> </channel> </rss>

Appendix 3,
Application Programming Interface (API) Specifications 34 / 76

  1. Z39.50

The example of returned data also applies to that of SRU. See the example of SRU.

Appendix 3,
Application Programming Interface (API) Specifications 35 / 76

  1. OAI-PMH

5.1. GetRecord

(1) Request example http://iss.ndl.go.jp/api/oaipmh?verb=GetRecord&identifier=oai:iss.ndl.go.jp:R100000002- I000009838175-00&[*Specify the data format]

  • Data format specification (i) For the oai_dc format metadataPrefix=oai_dc

(ii) For returned data in the dcndl format metadataPrefix=dcndl

(iii) For returned data in the dcndl format (acquires the Bibliographic data only) metadataPrefix=dcndl&onlyBib=true

(iv) For returned data in the dcndl_simple format metadataPrefix=dcndl_simple

Appendix 3,
Application Programming Interface (API) Specifications 36 / 76

(2) Examples of returned data

<?xml version="1.0" encoding="UTF-8"?>

<OAI-PMH xsi:schemaLocation="http://www.openarchives.org/OAI/2.0/ http://www.openarchives.or g/OAI/2.0/OAI-PMH.xsd" xmlns="http://www.openarchives.org/OAI/2.0/" xmlns:xsi="http://www.w 3.org/2001/XMLSchema-instance"> <responseDate>2014-01-27T03:04:52Z</responseDate> <request verb="GetRecord" metadataPrefix="oai_dc" identifier="oai:iss.ndl.go.jp:R100000002 -I000009838175-00">http://iss.ndl.go.jp/api/oaipmh</request> <GetRecord> <record> <header> <identifier>oai:iss.ndl.go.jp:R100000002-I000009838175-00</identifier> <datestamp>2013-10-22T00:00:00Z</datestamp> </header> <metadata>

  • Portion where returned data vary depending on the specified data.

    </metadata>
    </record> </GetRecord>
</OAI-PMH>
  • Data are returned in each data format as follows: (i) For the oai_dc format <oai_dc:dc xsi:schemaLocation="http://www.openarchives.org/OAI/2.0/oai_dc/ http://ww w.openarchives.org/OAI/2.0/oai_dc.xsd" xmlns:oai_dc="http://www.openarchives.org/OAI/ 2.0/oai_dc/" xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:xsi="http://www.w3.org /2001/XMLSchema-instance"> dc:title夏目漱石</dc:title> dc:creator夏目漱石 [著]</dc:creator> dc:publisher宝島社</dc:publisher> dc:languagejpn</dc:language> </oai_dc:dc>

(ii) For the dcndl format <rdf:RDF xmlns:dcterms="http://purl.org/dc/terms/" xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#" xmlns:dcndl="http://ndl.go.jp/dcndl/terms/" xmlns:foaf="http://xmlns.com/foaf/0.1/" xmlns:rdfs="http://www.w3.org/2000/01/rdf-schema#" xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:owl="http://www.w3.org/2002/07/owl#"> <dcndl:BibAdminResource rdf:about="http://iss.ndl.go.jp/books/R100000002- I000009838175-00"> dcndl:catalogingStatusC7</dcndl:catalogingStatus> dcndl:bibRecordCategoryR100000002</dcndl:bibRecordCategory> <dcndl:record rdf:resource="http://iss.ndl.go.jp/books/R100000002-I000009838175- 00#material"/> </dcndl:BibAdminResource> <dcndl:BibResource rdf:about="http://iss.ndl.go.jp/books/R100000002-I000009838175- 00#material"> Appendix 3,
Application Programming Interface (API) Specifications 37 / 76 <dcterms:identifier rdf:datatype="http://ndl.go.jp/dcndl/terms/JPNO">21519621</dcterms:identifier> <dcterms:identifier rdf:datatype="http://ndl.go.jp/dcndl/terms/ISBN">978-4-7966- 6732-6</dcterms:identifier> <rdfs:seeAlso rdf:resource="http://id.ndl.go.jp/jpno/21519621"/> <rdfs:seeAlso rdf:resource="http://iss.ndl.go.jp/isbn/9784796667326"/> dcterms:title夏目漱石</dcterms:title> dc:title rdf:Description rdf:value夏目漱石</rdf:value> dcndl:transcriptionナツメ ソウセキ</dcndl:transcription> </rdf:Description> </dc:title> dcndl:seriesTitle rdf:Description rdf:value別冊宝島. 名作クラシックノベル</rdf:value> dcndl:transcriptionベッサツ タカラジマ. メイサク クラシック ノベル </dcndl:transcription> </rdf:Description> </dcndl:seriesTitle> dcndl:partInformation rdf:Description dcterms:title坊っちゃん</dcterms:title> </rdf:Description> </dcndl:partInformation> dcndl:partInformation rdf:Description dcterms:title夢十夜</dcterms:title> </rdf:Description> </dcndl:partInformation> dcndl:partInformation rdf:Description dcterms:titleこころ</dcterms:title> </rdf:Description> </dcndl:partInformation> dcndl:partInformation rdf:Description dcterms:title硝子戸の中</dcterms:title> </rdf:Description> </dcndl:partInformation> dcterms:creator <foaf:Agent rdf:about="http://id.ndl.go.jp/auth/entity/00054222"> foaf:name夏目, 漱石, 1867-1916</foaf:name> dcndl:transcriptionナツメ, ソウセキ</dcndl:transcription> </foaf:Agent> </dcterms:creator> dc:creator夏目漱石 [著]</dc:creator> dcterms:publisher foaf:Agent foaf:name宝島社</foaf:name> dcndl:transcriptionタカラジマシャ< /dcndl:transcription> dcndl:location東京</dcndl:location> </foaf:Agent> </dcterms:publisher> <dcndl:publicationPlace rdf:datatype="http://purl.org/dc/terms/ISO3166">JP</dcndl:publicationPlace> dcterms:date2008.12</dcterms:date> <dcterms:issued rdf:datatype="http://purl.org/dc/terms/W3CDTF">2008</dcterms:issued> Appendix 3,
Application Programming Interface (API) Specifications 38 / 76 <dcterms:subject rdf:resource="http://id.ndl.go.jp/class/ndlc/KH426"/> <dcterms:subject rdf:resource="http://id.ndl.go.jp/class/ndc9/913.6"/> <dcterms:language rdf:datatype="http://purl.org/dc/terms/ISO639- 2">jpn</dcterms:language> dcterms:extent352p ; 21cm</dcterms:extent> dcndl:price714円</dcndl:price> dcterms:audience一般</dcterms:audience> <dcndl:materialType rdf:resource="http://ndl.go.jp/ndltype/Book" rdfs:label="図書 "/> dcterms:accessRightsS01P99U99</dcterms:accessRights> </dcndl:BibResource> <dcndl:BibResource rdf:about="http://iss.ndl.go.jp/books/R100000002-I000009838175- 00#material"> <dcndl:record rdf:resource="http://iss.ndl.go.jp/books/R100000002-I000009838175- 00#item"/> <dcndl:record rdf:resource="http://iss.ndl.go.jp/books/R100000001-I021731310- 00#item"/> </dcndl:BibResource> <dcndl:Item rdf:about="http://iss.ndl.go.jp/books/R100000002-I000009838175- 00#item"> dcndl:holdingAgent foaf:Agent foaf:name国立国会図書館</foaf:name> <dcterms:identifier rdf:datatype="http://ndl.go.jp/dcndl/terms/NDLLibCode">0000</dcterms:identifier> </foaf:Agent> </dcndl:holdingAgent> <rdfs:seeAlso rdf:resource="http://id.ndl.go.jp/bib/000009838175"/> <dcterms:identifier rdf:datatype="http://ndl.go.jp/dcndl/terms/NDLBibID">000009838175</dcterms:identifier

<dcndl:callNumber>KH426-J15</dcndl:callNumber>

</dcndl:Item> <dcndl:Item rdf:about="http://iss.ndl.go.jp/books/R100000001-I021731310-00#item"> dcndl:holdingAgent foaf:Agent foaf:name長崎県立長崎図書館</foaf:name> <dcterms:identifier rdf:datatype="http://ndl.go.jp/dcndl/terms/NDLLibCode">4211</dcterms:identifier> </foaf:Agent> </dcndl:holdingAgent> <dcterms:identifier rdf:datatype="http://ndl.go.jp/dcndl/terms/somokuBibID">1000000518398</dcterms:identi fier> <dcterms:identifier rdf:datatype="http://ndl.go.jp/dcndl/terms/somokuSubID">1117388283</dcterms:identifie r> dcndl:callNumber９１３．６／ナソ−０８／</dcndl:callNumber> dcndl:availability帯出可</dcndl:availability> dcterms:description配置場所 : 開架図書</dcterms:description> </dcndl:Item> </rdf:RDF>

(iii) For the dcndl format (acquires the Bibliographic data only) <rdf:RDF xmlns:dcterms="http://purl.org/dc/terms/" xmlns:rdf="http://www.w3.org/1999/ 02/22-rdf-syntax-ns#" xmlns:dcndl="http://ndl.go.jp/dcndl/terms/" xmlns:foaf="http:// xmlns.com/foaf/0.1/" xmlns:rdfs="http://www.w3.org/2000/01/rdf-schema#" xmlns:dc="htt

Appendix 3,
Application Programming Interface (API) Specifications 39 / 76 p://purl.org/dc/elements/1.1/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:owl="http://www.w3.org/2002/07/owl#"> <dcndl:BibAdminResource rdf:about="http://iss.ndl.go.jp/books/R100000002-I000009838 175-00"> dcndl:catalogingStatusC7</dcndl:catalogingStatus> dcndl:bibRecordCategoryR100000002</dcndl:bibRecordCategory> <dcndl:record rdf:resource="http://iss.ndl.go.jp/books/R100000002-I000009838175-0 0#material"/> </dcndl:BibAdminResource> <dcndl:BibResource rdf:about="http://iss.ndl.go.jp/books/R100000002-I000009838175-0 0#material"> <dcterms:identifier rdf:datatype="http://ndl.go.jp/dcndl/terms/JPNO">21519621</dc terms:identifier> <dcterms:identifier rdf:datatype="http://ndl.go.jp/dcndl/terms/ISBN">978-4-7966-6 732-6</dcterms:identifier> <rdfs:seeAlso rdf:resource="http://id.ndl.go.jp/jpno/21519621"/> <rdfs:seeAlso rdf:resource="http://iss.ndl.go.jp/isbn/9784796667326"/> dcterms:title夏目漱石</dcterms:title> dc:title rdf:Description rdf:value夏目漱石</rdf:value> dcndl:transcriptionナツメ ソウセキ</dcndl:transcription> </rdf:Description> </dc:title> dcndl:seriesTitle rdf:Description rdf:value別冊宝島. 名作クラシックノベル</rdf:value> dcndl:transcriptionベッサツ タカラジマ. メイサク クラシック ノベル</dcndl:t ranscription> </rdf:Description> </dcndl:seriesTitle> dcndl:partInformation rdf:Description dcterms:title坊っちゃん</dcterms:title> </rdf:Description> </dcndl:partInformation> dcndl:partInformation rdf:Description dcterms:title夢十夜</dcterms:title> </rdf:Description> </dcndl:partInformation> dcndl:partInformation rdf:Description dcterms:titleこころ</dcterms:title> </rdf:Description> </dcndl:partInformation> dcndl:partInformation rdf:Description dcterms:title硝子戸の中</dcterms:title> </rdf:Description> </dcndl:partInformation> dcterms:creator <foaf:Agent rdf:about="http://id.ndl.go.jp/auth/entity/00054222"> foaf:name夏目, 漱石, 1867-1916</foaf:name> dcndl:transcriptionナツメ, ソウセキ< /dcndl:transcription> </foaf:Agent> </dcterms:creator> dc:creator夏目漱石 [著]</dc:creator> dcterms:publisher Appendix 3,
Application Programming Interface (API) Specifications 40 / 76 foaf:Agent foaf:name宝島社</foaf:name> dcndl:transcriptionタカラジマシャ</dcndl:transcription> dcndl:location東京</dcndl:location> </foaf:Agent> </dcterms:publisher> <dcndl:publicationPlace rdf:datatype="http://purl.org/dc/terms/ISO3166">JP</dcnd l:publicationPlace> dcterms:date2008.12</dcterms:date> <dcterms:issued rdf:datatype="http://purl.org/dc/terms/W3CDTF">2008</dcterms:issu ed> <dcterms:subject rdf:resource="http://id.ndl.go.jp/class/ndlc/KH426"/> <dcterms:subject rdf:resource="http://id.ndl.go.jp/class/ndc9/913.6"/> <dcterms:language rdf:datatype="http://purl.org/dc/terms/ISO639-2">jpn</dcterms:l anguage> dcterms:extent352p ; 21cm</dcterms:extent> dcndl:price714円</dcndl:price> dcterms:audience一般</dcterms:audience> <dcndl:materialType rdf:resource="http://ndl.go.jp/ndltype/Book" rdfs:label="図書 "/> dcterms:accessRightsS01P99U99</dcterms:accessRights> </dcndl:BibResource> </rdf:RDF>

(iv) For dcndl_simple format <dcndl_simple:dc xmlns:dcterms="http://purl.org/dc/terms/" xmlns:dcndl_simple ="http://ndl.go.jp/dcndl/dcndl_simple/" xmlns:rdf="http://www.w3.org/1999/02/22-rdf-s yntax-ns#" xmlns:dcndl="http://ndl.go.jp/dcndl/terms/" xmlns:foaf="http://xmlns.com/f oaf/0.1/" xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:rdfs="http://www.w3.org/2 000/01/rdf-schema#" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:owl=" http://www.w3.org/2002/07/owl#"> <dc:identifier xsi:type="dcterms:URI">http://iss.ndl.go.jp/books/R100000002 -I000009838175-00</dc:identifier> dc:title夏目漱石</dc:title> dcndl:titleTranscriptionナツメ ソウセキ</dcndl:titleTranscription> dc:creator夏目漱石 [著]</dc:creator> dc:creator夏目, 漱石, 1867-1916</dc:creator> dcndl:creatorTranscriptionナツメ, ソウセキ</dcndl:creatorTranscription> dcndl:partTitle坊っちゃん</dcndl:partTitle> dcndl:partTitle夢十夜</dcndl:partTitle> dcndl:partTitleこころ</dcndl:partTitle> dcndl:partTitle硝子戸の中</dcndl:partTitle> dcndl:seriesTitle別冊宝島. 名作クラシックノベル</dcndl:seriesTitle> dcndl:seriesTitleTranscriptionベッサツ タカラジマ. メイサク クラシック ノ ベル</dcndl:seriesTitleTranscription> dcndl:publicationPlace東京</dcndl:publicationPlace> dc:publisher宝島社</dc:publisher> <dcterms:issued xsi:type="dcterms:W3CDTF">2008</dcterms:issued> dcndl:price714円</dcndl:price> dcterms:extent352p ; 21cm</dcterms:extent> <dc:identifier xsi:type="dcndl:ISBN">9784796667326</dc:identifier> <dc:identifier xsi:type="dcndl:JPNO">21519621</dc:identifier> <dc:subject xsi:type="dcndl:NDLC">KH426</dc:subject> <dc:subject xsi:type="dcndl:NDC9">913.6</dc:subject> dcndl:materialType図書</dcndl:materialType> dcterms:accessRightsS01P99U99</dcterms:accessRights> <rdfs:seeAlso rdf:resource="http://id.ndl.go.jp/bib/000009838175"></rdfs:se eAlso>

Page 4 of 8