ndlsearch_api_ap3_20180322_en.pdf

Type: Document | Status: ready
← All sources

Appendix 3,
Application Programming Interface (API) Specifications 41 / 76 <dcndl:publicationPlace xsi:type="dcterms:ISO3166">JP</dcndl:publicationPla ce> <dc:language xsi:type="ISO639-2">jpn</dc:language> </dcndl_simple:dc>

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

5.2. Identify

(1) Request example http://iss.ndl.go.jp/api/oaipmh?verb=Identify

(2) Example 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:08:07Z</responseDate> <request verb="Identify">http://iss.ndl.go.jp/api/oaipmh</request> <Identify> <repositoryName>NDL Digital Archive Portal</repositoryName> <baseURL>http://iss.ndl.go.jp/api/oaipmh</baseURL> <protocolVersion>Version 2.0</protocolVersion> <adminEmail></adminEmail> <earliestDatestamp>2013-10-22T00:00:00Z</earliestDatestamp> <deletedRecord>transient</deletedRecord> <granularity>YYYY-MM-DD</granularity> <repositoryIdentifier>oai:iss.ndl.go.jp:ID</repositoryIdentifier> </Identify> </OAI-PMH>

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

5.3. ListIdentifiers

(1) Request example http://iss.ndl.go.jp/api/oaipmh?verb=ListIdentifiers&&set=iss-ndl-opac:733&from=2014- 01-01&metadataPrefix=oai_dc

The returned data is always the same regardless of the data format specified, oai_dc, dcndl, or dcndl_simple, for metadataPrefix. (The request shown above is an example when oai_dc is specified.)

(3) Example 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:24:34Z</responseDate> <request verb="ListIdentifiers" set="iss-ndl-opac:733" metadataPrefix="oai_dc" from="2014- 01-01">http://iss.ndl.go.jp/api/oaipmh</request> <ListIdentifiers> <header> <identifier>oai:iss.ndl.go.jp:R100000002-I000002673301-00</identifier> <datestamp>2014-01-07T00:00:00Z</datestamp> </header> <header> <identifier>oai:iss.ndl.go.jp:R100000002-I000002694768-00</identifier> <datestamp>2014-01-07T00:00:00Z</datestamp> </header> <header> <identifier>oai:iss.ndl.go.jp:R100000002-I000008141097-00</identifier> <datestamp>2014-01-07T00:00:00Z</datestamp> </header> <resumptionToken completeListSize="3" cursor=""></resumptionToken> </ListIdentifiers> </OAI-PMH>

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

5.4. ListMetadataFormats

(1) Request example http://iss.ndl.go.jp/api/oaipmh?verb=ListMetadataFormats

(2) Example 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:25:09Z</responseDate> <request verb="ListMetadataFormats">http://iss.ndl.go.jp/api/oaipmh</request> <ListMetadataFormats> <metadataFormat> <metadataPrefix>oai_dc</metadataPrefix> <schema>http://www.openarchives.org/OAI/2.0/oai_dc.xsd</schema> <metadataNamespace>http://www.openarchives.org/OAI/2.0/oai_dc/</metadataNamespace> </metadataFormat> <metadataFormat> <metadataPrefix>dcndl</metadataPrefix> <schema>http://porta.ndl.go.jp/schema/dcndl.xsd</schema> <metadataNamespace>http://ndl.go.jp/dcndl/terms/</metadataNamespace> </metadataFormat> <metadataFormat> <metadataPrefix>dcndl_simple</metadataPrefix> <schema></schema> <metadataNamespace>http://ndl.go.jp/dcndl/dcndl_simple/</metadataNamespace> </metadataFormat> </ListMetadataFormats> </OAI-PMH>

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

5.5. ListRecords

(1) Request example http://iss.ndl.go.jp/api/oaipmh?verb=ListRecords&&set=iss-ndl-opac:733&from=2014-01-01&[*Data format is specified]

  • 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

(2) Example of returned data

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

<OAI-PMH xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#" xsi:schemaLocation="http:// www.openarchives.org/OAI/2.0/ http://www.openarchives.org/OAI/2.0/OAI-PMH.xsd" xmlns="http:/ /www.openarchives.org/OAI/2.0/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <responseDate>2014-01-27T03:25:55Z</responseDate> <request verb="ListRecords" set="iss-ndl-opac:733" metadataPrefix="oai_dc" from="2014-01-0 1">http://iss.ndl.go.jp/api/oaipmh</request> <ListRecords>

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

    <resumptionToken completeListSize="3" cursor=""></resumptionToken> </ListRecords>

    </OAI-PMH>

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

  • Data are returned in each data format as follows: (i) For the oai_dc format <record> <header> <identifier>oai:iss.ndl.go.jp:R100000002-I000002673301-00</identifier> <datestamp>2014-01-07T00:00:00Z</datestamp> </header> <metadata> <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:creator日本アート・センター 編</dc:creator> dc:description年表あり</dc:description> dc:publisher新潮社</dc:publisher> dc:languagejpn</dc:language> </oai_dc:dc> </metadata> </record> <record> <header> <identifier>oai:iss.ndl.go.jp:R100000002-I000002694768-00</identifier> <datestamp>2014-01-07T00:00:00Z</datestamp> </header> <metadata> <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:creator種村季弘 解説</dc:creator> dc:description編集: アートダイジェスト</dc:description> dc:publisher京都書院</dc:publisher> dc:languagejpn</dc:language> </oai_dc:dc> </metadata> </record> <record> <header> <identifier>oai:iss.ndl.go.jp:R100000002-I000008141097-00</identifier> <datestamp>2014-01-07T00:00:00Z</datestamp> </header> <metadata> <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:subject木版画--ヨーロッパ--画集</dc:subject> dc:description会期・会場: 20 05年10月8日-12月11日</dc:description> dc:description編集: 幸福輝ほか</dc:description> dc:description共同刊行: 西洋美術振興財団</dc:description> Appendix 3,
    Application Programming Interface (API) Specifications 47 / 76 dc:publisher国立西洋美術館</dc:publisher> dc:languagejpn</dc:language> </oai_dc:dc> </metadata> </record>

(ii) For the dcndl format <record> <header> <identifier>oai:iss.ndl.go.jp:R100000002-I000002673301-00</identifier> <datestamp>2014-01-07T00:00:00Z</datestamp> </header> <metadata> <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 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-I000002673 301-00"> dcndl:catalogingStatusC7</dcndl:catalogingStatus> dcndl:bibRecordCategoryR100000002</dcndl:bibRecordCategory> <dcndl:record rdf:resource="http://iss.ndl.go.jp/books/R100000002-I000002673301-0 0#material"/> </dcndl:BibAdminResource> <dcndl:BibResource rdf:about="http://iss.ndl.go.jp/books/R100000002-I000002673301-0 0#material"> <dcterms:identifier rdf:datatype="http://ndl.go.jp/dcndl/terms/JPNO">98068546</dc terms:identifier> <dcterms:identifier rdf:datatype="http://ndl.go.jp/dcndl/terms/ISBN">4-10-601564- 1</dcterms:identifier> <rdfs:seeAlso rdf:resource="http://id.ndl.go.jp/jpno/98068546"/> <rdfs:seeAlso rdf:resource="http://iss.ndl.go.jp/isbn/4106015641"/> 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新潮日本美術文庫 ; 44</rdf:value> dcndl:transcriptionシンチョウ ニホン ビジュツ ブンコ</dcndl:transcription> </rdf:Description> </dcndl:seriesTitle> dcterms:creator <foaf:Agent rdf:about="http://id.ndl.go.jp/auth/entity/00048284"> foaf:name棟方, 志功, 1903-1975</foaf:name> dcndl:transcriptionムナカタ, シコウ</dcndl:transcription> </foaf:Agent> </dcterms:creator> dcterms:creator <foaf:Agent rdf:about="http://id.ndl.go.jp/auth/entity/00293314"> foaf:name日本アートセンター</foaf:name> </foaf:Agent> </dcterms:creator> dc:creator棟方志功 [画]</dc:creator>

Appendix 3,
Application Programming Interface (API) Specifications 48 / 76 dc:creator日本アート・センター 編</dc:creator> dcterms:publisher foaf:Agent foaf:name新潮社</foaf:name> dcndl:location東京</dcndl:location> </foaf:Agent> </dcterms:publisher> <dcndl:publicationPlace rdf:datatype="http://purl.org/dc/terms/ISO3166">JP</dcnd l:publicationPlace> dcterms:date1998.3</dcterms:date> <dcterms:issued rdf:datatype="http://purl.org/dc/terms/W3CDTF">1998</dcterms:issu ed> dcterms:description年表あり</dcterms:description> <dcterms:subject rdf:resource="http://id.ndl.go.jp/class/ndlc/KC16"/> <dcterms:subject rdf:resource="http://id.ndl.go.jp/class/ndlc/KC229"/> <dcterms:subject rdf:resource="http://id.ndl.go.jp/class/ndc9/733.087"/> <dcterms:language rdf:datatype="http://purl.org/dc/terms/ISO639-2">jpn</dcterms:l anguage> dcterms:extent93p ; 20cm</dcterms:extent> dcndl:price1068円</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-I000002673301-0 0#material"> <dcndl:record rdf:resource="http://iss.ndl.go.jp/books/R100000002-I000002673301-0 0#item"/> <dcndl:record rdf:resource="http://iss.ndl.go.jp/books/R100000001-I007456230-00#i tem"/> <dcndl:record rdf:resource="http://iss.ndl.go.jp/books/R100000001-I007695860-00#i tem"/> <dcndl:record rdf:resource="http://iss.ndl.go.jp/books/R100000001-I019851292-00#i tem"/> <dcndl:record rdf:resource="http://iss.ndl.go.jp/books/R100000001-I021437618-00#i tem"/> <dcndl:record rdf:resource="http://iss.ndl.go.jp/books/R100000001-I048587373-00#i tem"/> <dcndl:record rdf:resource="http://iss.ndl.go.jp/books/R100000001-I048937403-00#i tem"/> </dcndl:BibResource> <dcndl:Item rdf:about="http://iss.ndl.go.jp/books/R100000002-I000002673301-00#item"

<dcndl:holdingAgent> 

  <foaf:Agent> 
    <foaf:name>国立国会図書館</foaf:name> 
    <dcterms:identifier rdf:datatype="http://ndl.go.jp/dcndl/terms/NDLLibCode">00

00</dcterms:identifier> </foaf:Agent> </dcndl:holdingAgent> <rdfs:seeAlso rdf:resource="http://id.ndl.go.jp/bib/000002673301"/> <dcterms:identifier rdf:datatype="http://ndl.go.jp/dcndl/terms/NDLBibID">00000267 3301</dcterms:identifier> dcndl:callNumberKC16-G1189</dcndl:callNumber> </dcndl:Item> <dcndl:Item rdf:about="http://iss.ndl.go.jp/books/R100000001-I007456230-00#item"> dcndl:holdingAgent foaf:Agent

Appendix 3,
Application Programming Interface (API) Specifications 49 / 76 foaf:name高知県立図書館</foaf:name> <dcterms:identifier rdf:datatype="http://ndl.go.jp/dcndl/terms/NDLLibCode">39 11</dcterms:identifier> </foaf:Agent> </dcndl:holdingAgent> <dcterms:identifier rdf:datatype="http://ndl.go.jp/dcndl/terms/somokuBibID">00043 4935</dcterms:identifier> <dcterms:identifier rdf:datatype="http://ndl.go.jp/dcndl/terms/somokuSubID">11038 85362</dcterms:identifier> dcndl:callNumberKX/733/5</dcndl:callNumber> dcndl:availability持禁</dcndl:availability> dcterms:description配置場所 : 郷土書庫</dcterms:description> dcterms:description郷土資料</dcterms:description> </dcndl:Item> <dcndl:Item rdf:about="http://iss.ndl.go.jp/books/R100000001-I007695860-00#item"> dcndl:holdingAgent foaf:Agent foaf:name高知県立図書館</foaf:name> <dcterms:identifier rdf:datatype="http://ndl.go.jp/dcndl/terms/NDLLibCode">39 11</dcterms:identifier> </foaf:Agent> </dcndl:holdingAgent> <dcterms:identifier rdf:datatype="http://ndl.go.jp/dcndl/terms/somokuBibID">00021 9262</dcterms:identifier> <dcterms:identifier rdf:datatype="http://ndl.go.jp/dcndl/terms/somokuSubID">11015 66915</dcterms:identifier> dcndl:callNumber720.8/44</dcndl:callNumber> dcndl:availability可能</dcndl:availability> dcterms:description配置場所 : 一般開</dcterms:description> </dcndl:Item> <dcndl:Item rdf:about="http://iss.ndl.go.jp/books/R100000001-I019851292-00#item"> dcndl:holdingAgent foaf:Agent foaf:name大阪府立中之島図書館</foaf:name> <dcterms:identifier rdf:datatype="http://ndl.go.jp/dcndl/terms/NDLLibCode">27 12</dcterms:identifier> </foaf:Agent> </dcndl:holdingAgent> <dcterms:identifier rdf:datatype="http://ndl.go.jp/dcndl/terms/somokuBibID">10000 001453417</dcterms:identifier> dcndl:callNumber７３３／６１Ｎ</dcndl:callNumber> </dcndl:Item> <dcndl:Item rdf:about="http://iss.ndl.go.jp/books/R100000001-I021437618-00#item"> dcndl:holdingAgent foaf:Agent foaf:name福岡市総合図書館</foaf:name> <dcterms:identifier rdf:datatype="http://ndl.go.jp/dcndl/terms/NDLLibCode">40 22</dcterms:identifier> </foaf:Agent> </dcndl:holdingAgent> <dcterms:identifier rdf:datatype="http://ndl.go.jp/dcndl/terms/somokuBibID">10098 10013506</dcterms:identifier> <dcterms:identifier rdf:datatype="http://ndl.go.jp/dcndl/terms/somokuSubID">75001 61190</dcterms:identifier> dcndl:callNumber７３３／ム／</dcndl:callNumber> dcndl:availability帯出可</dcndl:availability> </dcndl:Item> <dcndl:Item rdf:about="http://iss.ndl.go.jp/books/R100000001-I048587373-00#item"> dcndl:holdingAgent

Page 5 of 8