Appendix 4,
Application Programming Interface (API) Specifications
List of Collection Codes and Access Rights
Table 1 and Table2 list the latest Collection Codes and Access Rights. Collection Codes and Access Rights can be specified in harvesting API (OAI-PMH) only. Rights cannot be specified in search API (SRU, SRW, OpenSearch and Z39.50).
Table 1 lists Collection Codes for NDL Digital Collections (Digitized Contents) and NDL Digital Collections (Online publications).
For Collection Codes, forward match shall be applied. For example, if "D00" (Books) is specified, bibliographic data with the Collection Code "D00" (Books), "D001" (National Diet Library), "D0011" (National Diet Library Research and LegislativeReference Bureau) will be returned. You can also specify only the code "D" ("D" is an identifier for NDL Digital Collections [Digitized Contents]) or "I" ("I" is an identifier for NDL Digital Collections [Online publications]). Please note you cannot specify multiple Collection Codes at one time.
Collection Code "D02" (Rare Books and Old Materials) is exceptional. If "D02" is specified, bibliographic data with the Collection Code for any of "D20" (Nisiki-e) or "D21" (E-zu) or "D22" (Important Cultural Properties) or "D23" (Old Western books) or "D24" (Others) will be returned. As another exceptional code, a request specified for “D071A” will return data of “D071A” only because a relationship between “D071A” and “D071AA-AO” is not nested.
Collection Name for each data of National Diet Library Digital Collections can be seen on the website (http://dl.ndl.go.jp/). Please check the field of “Collection Information (type:collection)” on the Detailed Record View for Metadata.
Table 1 List of Collection Code Identification Collection Code Collection Digitized Contents D
Digitized Contents
D00
Books
D001
National Diet Library
D0011
National Diet Library Research and LegislativeReference Bureau
D01
Periodicals
D011
National Diet Library
D0111
National Diet Library Research and LegislativeReference Bureau
D02
Rare Books and Old Materials
Appendix 4,
Application Programming Interface (API) Specifications
Identification Collection Code Collection
D20
Nisiki-e
D21
E-zu
D22
Important Cultural Properties
D23
Old Western books
D24
Others
D04
Doctoral Dissertations
D05
Official Gazettes
D06
Materials on the Allied Occupation of Japan
D061
Records of the U.S. Strategic Bombing Survey (USSBS)
D0611
USSBS Transcripts of Interrogations and Interrogation Reports of Japanese Industrial, Military, and Political Leaders (Entry 43)
D0612
Reports of Japanese Responses to Questionnaires Relating to Japanese Air Strength (Entry 44)
D0613
Intelligence Library (Entry 46)
D0614
Joint Target Group Air Target Analyses (Entry 47)
D0615
Air Objective Folders (Entry 48)
D0616
Joint Army-Navy Intelligence Studies (JANIS) (Entry 49)
D0617
Japanese Resources Reference Notebooks (Entry 50)
D0618
Statistical Reports Covering Allied and U.S. Air Forces Attack Data (Entry 51)
D0619
Operations Reports (Entry 52)
D061A
Tactical Mission Reports of the 20th & 21st Bomber Commands (Entry 53)
D061B
Land-Based Navy and Marine Corps Aircraft Action Reports (Entry 54)
D061C
Carrier-Based Navy and Marine Corps Aircraft Action Reports (Entry 55)
D061D
U. S. Naval Air Narrative and Statistical Operations Summaries and Reports (Entry 56)
D061E
Naval Surface Action Reports, June 30 - Sept. 1 (Entry 57)
D061F
Statistical Summaries of Naval Minefields in the Far East (Entry 58)
D061G
Damage Assessment Reports (Entry 59)
D061H
20th Air Force Damage Assessment Cards (Entry 60)
D061I
Aerial Photographs of Japanese Targets (Entry 72)
D061J
No Entry Number
D061K
Pacific Survey Reports and Supporting Records (Entry 41)
D062
Records of the Far East Command, Supreme Commander for the Allied Powers, and United Nations Command, 1945- 1960
D0621
Assistant Chief of Staff (G-2)
D0622
Assistant Chief of Staff (G-3)
D0623
Assistant Chief of Staff (G-4)
D063
Others
D0631
Illustrations of Reports of General MacArthur
D0632
Japanese Monographs
D064
Records of General Headquarters Supreme Commander for the Allied Powers
D0641
Government Section
D0642
Top Secret Records of Various Sections（TS）
D0643
International Prosecution Section（IPS）
D0644
Directives to the Japanese Government（SCAPINs）
D0645
Civil Affairs Section (CAS)
D07
Modern Japanese political history materials
D071
Document Name
D0711
Aoki Shuzo Papers
Appendix 4,
Application Programming Interface (API) Specifications
Identification Collection Code Collection
D0712
Akamatu Noriyoshi Papers
D071I
Ishiguro Tadanori Papers
D0713
Ishida Eikichi Papers
D0714
Ito Hirobumi Papers (No.1)
D0715
Ito Hirobumi Papers (No.2)
D0716
Ito Miyoji Papers
D0717
Katsu Kaishu Papers
D0718
Katsura Taro Papers
D0719
Modern Japanese Political History Materials Room Collection
D071A
Kono Hironaka Papers
D071B
Sato Tatsuo Papers
D071K
Shimomura Hiroshi Papers
D071C
Tsuda Mamichi Papers
D071J
Nagata Hidejiro, Ryoichi Papers
D071D
Nishi Amane Papers
D071E
Hamaguchi Osachi Papers
D071F
Furusawa Shigeru Papers
D071H
Mutsu Munemitsu Papers
D071L
Sugiura Yuzuru Papers
D071M
Inoue Kaoru Papers
D071N
Sanjo Family Papers
D071O
Sameshima Naonobu, Takenosuke Papers
D071P
Maeda Masana Papers
D071Q
Nakae Chomin Papers
D071R
Oki Takato Papers
D071S
Makino Nobuaki Papers
D071T
Saionji Kinmochi Papers
D071U
Otori Keisuke Papers
D071V
Enomoto Takeaki Papers
D071W
Ando Masazumi Papers
D071X
Saito Makoto Papers
D071Y
Mishima Michitsune Papers
D071Z
Tsurumi Yusuke Papers
D071AA
Sekiya Teizaburo Papers
D071AB
Yanagiwara Sakimitu Papers
D071AC
Sakatani Yoshiro Papers
D071AD
Arima Yoriyasu Papers
D071AE
Araki Sadao Papers
D071AF
Morimoto Kakuya Papers
D071AG
Ueno Kagenori Papers
D071AH
Tatsukawa Unpei Papers
D071AI
Kawakami Naonosuke Papers
D071AJ
Oyama Iwao Papers
D071AK
Watanabe Chiaki Papers
D071AL
Kabayama Sukenori Papers (No.2)
D071AM
Hasegawa Kiyoshi Papers
D071AN
Tanaka Giichi Papers
D071AO
Nagasaki Shogo Paper
D072
Material Type
D0721
Correspondences
D0722
Manuscripts
D0723
Diaries
D0724
Photographs
D0725
Images
D11
Prange Collection
D111
Books
D112
Children’s Books
D113
Periodicals
Appendix 4,
Application Programming Interface (API) Specifications
Identification Collection Code Collection
D114
Censored Newspaper Articles(CNA)
D12
Braille data
D16
Audio-Visual materials
D161
Scripts
D1611
TV
D1612
Radio
D1613
Related documents
D162
Music Manuscripts
D163
Audio materials
D164
Visual materials
D17
Collections from Other Institutions
D171
Ishinomaki Hibi Shimbun
D172
Science Film
D173
Digitized materials of the University of Tokyo Library System
D174
EXPO Aichi
D1741
Books
D1742
Video
D175
Naimusho Keihokyoku Censorship Collection
D90
Historical Recordings Online publications I
Online Publications
I1
National Agencies
I11
National Diet (Congress of Japan)
I1101
House of Representatives
I1102
House of Councillors
I1103
Judge Impeachment Court
I1104
Judge Indictment Committee
I1105
National Diet Library
I11051 National Diet Library Research and LegislativeReference Bureau
I12
Administrative Agencies
I1201
Cabinet Secretariat
I12011 Prime Minister of Japan and His Cabinet
I1202
Cabinet Legislation Bureau
I1203
National Personnel Authority
I1204
Cabinet Office
I12041 Imperial Household Agency
I12042 National Public Safety Commission
I12043 National Police Agency
I12044 Financial Services Agency
I12045 Fair Trade Commission
I12046 Consumer Affairs Agency
I12047 Personal Information Protection Commission
I1205
Reconstruction Agency
I1206
Ministry of Internal Affairs and Communications
I12061 Fire and Disaster Management Agency
I12062 Environmental Dispute Coordination Commission
I1207
Ministry of Justice
I12071 Public Prosecutors Office
I12072 Public Security Intelligence Agency
I12073 Public Security Examination Commission
I1208
Ministry of Foreign Affairs
I1209
Ministry of Finance
I12091 National Tax Agency
I1210
Ministry of Education, Culture, Sports, Science and Technology
I12101 Agency for Cultural Affairs
I12102 Japan Sports Agency
I1211
Ministry of Health, Labour and Welfare
I12111 Central Labour Relations Commission
Appendix 4,
Application Programming Interface (API) Specifications
Identification Collection Code Collection
I1212
Ministry of Agriculture, Forestry and Fisheries
I12121 Forestry Agency
I12122 Fisheries Agency
I1213
Ministry of Economy, Trade and Industry
I12131 Agency for Natural Resource and Energy
I12132 Japan Patent Office
I12133 Small and Medium Enterprise Agency
I1214
Ministry of Land, Infrastructure and Transport
I12141 Japan Meteorological Agency
I12142 Japan Coast Guard
I12143 Japan Tourism Agency
I12144 Japan Transport Safety Board
I12145 Geographical Survey Institute
I1215
Ministry of the Environment
I12151 Nuclear Regulation Authority
I1216
Ministry of Defense
I12161 Acquisition, Technology & Logistics Agency
I1217
Board of Audit
I13
Courts of Law
I2
Local Government
I21
Prefectures
I2101
Hokkaido
I2102
Aomori Prefecture
I2103
Iwate Prefecture
I2104
Miyagi Prefecture
I2105
Akita Prefecture
I2106
Yamagata Prefecture
I2107
Fukushima Prefecture
I2108
Ibaraki Prefecture
I2109
Tochigi Prefecture
I2110
Gunma Prefecture
I2111
Saitama Prefecture
I2112
Chiba Prefecture
I2113
Tokyo Metropolitan
I2114
Kanagawa Prefecture
I2115
Niigata Prefecture
I2116
Toyama Prefecture
I2117
Ishikawa Prefecture
I2118
Fukui Prefecture
I2119
Yamanashi Prefecture
I2120
Nagano Prefecture
I2121
Gifu Prefecture
I2122
Shizuoka Prefecture
I2123
Aichi Prefecture
I2124
Mie Prefecture
I2125
Shiga Prefecture
I2126
Kyoto Prefecture
I2127
Osaka Prefecture
I2128
Hyogo Prefecture
I2129
Nara Prefecture
I2130
Wakayama Prefecture
I2131
Tottori Prefecture
I2132
Shimane Prefecture
I2133
Okayama Prefecture
I2134
Hiroshima Prefecture
I2135
Yamaguchi Prefecture
I2136
Tokushima Prefecture
I2137
Kagawa Prefecture
I2138
Ehime Prefecture
I2139
Kochi Prefecture
Appendix 4,
Application Programming Interface (API) Specifications
Identification Collection Code Collection
I2140
Fukuoka Prefecture
I2141
Saga Prefecture
I2142
Nagasaki Prefecture
I2143
Kumamoto Prefecture
I2144
Oita Prefecture
I2145
Miyazaki Prefecture
I2146
Kagoshima Prefecture
I2147
Okinawa Prefecture
I23
Municipalities
I2301
Hokkaido
I2302
Aomori Prefecture
I2303
Iwate Prefecture
I2304
Miyagi Prefecture
I2305
Akita Prefecture
I2306
Yamagata Prefecture
I2307
Fukushima Prefecture
I2308
Ibaraki Prefecture
I2309
Tochigi Prefecture
I2310
Gunma Prefecture
I2311
Saitama Prefecture
I2312
Chiba Prefecture
I2313
Tokyo Metropolitan
I2314
Kanagawa Prefecture
I2315
Niigata Prefecture
I2316
Toyama Prefecture
I2317
Ishikawa Prefecture
I2318
Fukui Prefecture
I2319
Yamanashi Prefecture
I2320
Nagano Prefecture
I2321
Gifu Prefecture
I2322
Shizuoka Prefecture
I2323
Aichi Prefecture
I2324
Mie Prefecture
I2325
Shiga Prefecture
I2326
Kyoto Prefecture
I2327
Osaka Prefecture
I2328
Hyogo Prefecture
I2329
Nara Prefecture
I2330
Wakayama Prefecture
I2331
Tottori Prefecture
I2332
Shimane Prefecture
I2333
Okayama Prefecture
I2334
Hiroshima Prefecture
I2335
Yamaguchi Prefecture
I2336
Tokushima Prefecture
I2337
Kagawa Prefecture
I2338
Ehime Prefecture
I2339
Kochi Prefecture
I2340
Fukuoka Prefecture
I2341
Saga Prefecture
I2342
Nagasaki Prefecture
I2343
Kumamoto Prefecture
I2344
Oita Prefecture
I2345
Miyazaki Prefecture
I2346
Kagoshima Prefecture
I2347
Okinawa Prefecture
I3
Special Wards
I31
Borough
I32
Special district authority
I33
Others
Appendix 4,
Application Programming Interface (API) Specifications
Identification Collection Code Collection
I4
Academic Institutions
I41
National Universities
I42
Public Universities
I43
Private Universities
I44
Inter-University Research Institute Corporation
I45
Academic Associations
I5
Independent Administrative Agencies
I6
Others
Access Rights indicate the access restrictions for NDL Digital Collections (Digitized Contents) and NDL Digital Collections (Online publications). Table 2 lists a type of Access Rights.
Table 2 List of Access Rights Access Rights Restriction ARinternet Available Online ARkannai Available only at the NDL) ARsoshin Available only at the NDL and partner libraries) ARrekion Available only at the NDL and the Historical Recordings Collection (Rekio n) partner libraries)
Table 3 lists Request examples for Collection Code and Access Rights in NDL Digital Collections. For example, when you acquire newly registered or updated data during March 2017, insert the actual value of “set” in Table 3 in the following basic URL.
・basic URL ※Please make a change in the value of “matadataPrefix” , “from” , or “until” accordingly.
http://iss.ndl.go.jp/api/oaipmh?verb=ListRecords&metadataPrefix=dcndl&set=【the actual value of “set” in Table 3】&from=yyyy-mm-dd&until=yyyy-mm-dd
・URL in which the actual value of “set” in Table 3 is inserted
http://iss.ndl.go.jp/api/oaipmh?verb=ListRecords&metadataPrefix=dcndl&set=ndl- dl:D00:ARinternet&from=2017-03-01&until=2017-03-31
Appendix 4,
Application Programming Interface (API) Specifications
Table 3 List of Request examples Material Type Access Rights Available Online Available only at the NDL and partner libraries Available only at the NDL Books set=ndl- dl:D00:ARint ernet set=ndl- dl:D00:ARsoshin set=ndl- dl:D00:ARkannai Rare books set=ndl- dl:D02:ARint ernet set=ndl- dl:D02:ARsoshin set=ndl- dl:D02:ARkannai Periodicals set=ndl- dl:D01:ARint ernet set=ndl- dl:D01:ARsoshin set=ndl- dl:D01:ARkannai Doctoral dissertations set=ndl- dl:D04:ARint ernet set=ndl- dl:D04:ARsoshin set=ndl- dl:D04:ARkannai