― 外部提供インタフェース(API)
1. 国立国会図書館東日本大震災アーカイブ（愛称：ひなぎく）で提供するAPI
ひなぎくでは、検索用APIとハーベスト用APIの2種類のAPIを提供しており、「メタデータ取得可能な提供元一覧」の全ての提供元について、両方のAPIでメタデータを取得することできます。
APIを利用される前に、必ず、「API利用申請について」をご一読ください。また、ひなぎく以外のサービスでAPIのご利用を希望される場合は、国立国会図書館ホームページ「APIの利用」をご覧ください。
1.1. 検索用API
ひなぎくの検索ができます。指定できる検索条件は、使用するAPIのプロトコルによって異なります。
SRU、OpenSearchに対応しています。
検索用APIを組み込むことにより検索窓等を作成することができます。
1.2. ハーベスト用API
ひなぎくに格納されたメタデータのダウンロードができます。
OAI-PMHで提供しています。
ひなぎくからメタデータをダウンロードし、他のシステムに取り込むこと等ができます。
※機能の一部でキャッシュ機能を用いているため、リクエスト条件やタイミングによって応答性能が大きく変わる場合があります。
1.3. APIの概要
各APIの概要は、下表のとおりです。概要表の詳細については、共通事項(PDFファイル)をご覧ください。
| 種別 | プロトコル | 入力形式 | 出力形式 | アクセスURL | 備考 |
|---|---|---|---|---|---|
| 検索用API | SRU | URL | XML(RDF) | https://kn.ndl.go.jp/api/sru | ひなぎくの簡易検索画面及び詳細検索画面からの検索と同じ検索が行えます。 |
| 検索用API | OpenSearch | URL | XML(RSS) | https://kn.ndl.go.jp/api/opensearch | |
| ハーベスト用API | OAI-PMH | URL | XML | https://kn.ndl.go.jp/api/oaipmh |
各プロトコルの詳細は、プロトコル名のリンク先ページをご覧ください。
2. APIにより提供されるデータ
2.1. 提供データ
メタデータのみを提供しています。
2.2. メタデータの形式
ひなぎくが持つメタデータは、「国立国会図書館ダブリンコアメタデータ記述（DC-NDL）」を基に作成された「国立国会図書館東日本大震災アーカイブメタデータスキーマ」に従っています。
各プロトコルで返戻されるデータの形式も、「国立国会図書館東日本大震災アーカイブメタデータスキーマ」を基本形としています。
2.3. メタデータの更新時期
メタデータの更新は即時ではなく、日次のバッチ処理で更新されます。
このため、午前0時ちょうど(日付が変わった直後)にAPIを使用して、検索あるいはメタデータの収集を行った場合、前日のメタデータ更新が反映されていないメタデータが含まれる可能性があります。
2.4. メタデータ取得可能な提供元一覧
APIをご利用いただく際に、以下の提供元のリポジトリIDを指定することで検索対象を絞り込むことができます。全ての提供元について、検索用APIとハーベスト用APIの両方でメタデータを取得することできます。
各リポジトリの概要については、「検索対象データベース等一覧」をご覧ください。
国立国会図書館によるメタデータ提供(2024年7月12日時点)
| リポジトリID | 提供元 | メタデータ二次利用条件（○は申請不要。×は利用不可） | |
|---|---|---|---|
| 非営利目的 | 営利目的 | ||
| R200000002 | 国立国会図書館蔵書 | ○ | ○ |
| R200000004 | 国立国会図書館雑誌記事索引 | ○ | ○ |
| R200000007 | カレントアウェアネス・ポータル (国立国会図書館) | ○ | 要申請 |
| R200100039 | 国立国会図書館デジタルコレクション | ○ | 要申請 |
| R200200001 | その他提供元 (個人) | ○ | ○ |
| R200200006 | 国立国会図書館インターネット資料収集保存事業 (WARP) | ○ | ○ |
| R200200015 | 国会事故調 (東京電力福島原子力発電所事故調査委員会) | ○ | ○ |
| R200200017 | ジャパン・プラットフォーム (JPF) | ○ | ○ |
| R200200018 | ジュピター テレコム (J:COM) | ○ | ○ |
| R200200020 | 東京製本倶楽部 | ○ | ○ |
| R200200022 | 東京電力ホールディングス | ○ | ○ |
| R200200024 | 国際協力NGOセンター (JANIC) | ○ | ○ |
| R200200027 | その他提供元 (団体) | ○ | ○ |
| R200200028 | 国際交流基金 | ○ | ○ |
| R200200029 | 東日本激災復興新聞 (日本建設新聞社) | ○ | ○ |
| R200200030 | 被災地斜め航空写真 (朝日航洋) | ○ | ○ |
| R200200039 | 福島県新地町被災写真 (新地町図書館) | ○ | ○ |
| R200200040 | ICT地域の絆保存プロジェクト「東日本大震災を語り継ぐ」 (東松島市図書館) | ○ | ○ |
| R200200041 | 国立国会図書館 | ○ | ○ |
| R200200047 | 原子力規制委員会 | ○ | ○ |
| R200200048 | 日本財団 | ○ | ○ |
| R200200050 | 政府インターネットテレビ | ○ | ○ |
| R200200052 | 国土地理院 | ○ | ○ |
| R200200058 | 環境省 | ○ | ○ |
| R200200059 | 防衛省 | ○ | ○ |
| R200200064 | 防災科学技術研究所自然災害情報室 | ○ | ○ |
| R200200069 | 東海新報 (東海新報社) | ○ | ○ |
| R200200070 | 災害撮影 [事業活動と社会貢献] (株式会社パスコ) | ○ | ○ |
| R200200072 | 邑計画事務所 | ○ | ○ |
| R200200073 | 大槌町水道事業所 | ○ | ○ |
| R200200074 | 高田自動車学校 | ○ | ○ |
| R200200076 | 〈盛岡〉設計同人 | ○ | ○ |
| R200200077 | 厚生労働省 | ○ | ○ |
| R200200078 | 原子力規制委員会 (東京電力福島第一原子力発電所事故情報に係るアーカイブ) | ○ | ○ |
| R200200079 | 国際航業 | ○ | ○ |
| R200200080 | 首相官邸 | ○ | ○ |
| R200200082 | 写真企画 | ○ | ○ |
| R200200083 | 長岡市歴史文書館 | ○ | ○ |
| R200200084 | 共同通信社 | ○ | ○ |
| R200200087 | 味の素 | ○ | ○ |
| R200200088 | 宮城県図書館 | ○ | ○ |
| R200200089 | 岩手県立図書館 | ○ | ○ |
| R200200096 | 内閣府 | ○ | ○ |
| R200200098 | 復興庁 | ○ | ○ |
| R200200099 | 岩手未来機構 | ○ | ○ |
| R200200102 | 国立国会図書館収集震災関係チラシ等 | ○ | ○ |
| R200200104 | 石巻市復興を考える市民の会 | ○ | ○ |
| R200200112 | いま私たち市民にできることプロジェクト | ○ | ○ |
他機関によるメタデータ提供(2024年7月12日時点)
| リポジトリID | 提供元 | サイトポリシー |
|---|---|---|
| R200200004 | 日本原子力研究開発機構図書館蔵書 | https://www.jaea.go.jp/policy.html |
| R200200031 | 東日本大震災の記録 (学校法人東北学院) | https://www.tohoku-gakuin.jp/general/site_policy.html |
| R200200033 | NWEC災害復興支援女性アーカイブ (国立女性教育会館) | https://w-archive.nwec.go.jp/il/meta_pub/G0000337wd |
| R200200044 | 市町村史に記された地震の記録 (埼玉県立熊谷図書館) | https://www.pref.saitama.lg.jp/a0301/tyosaku-rinku.html |
| R200200045 | わかりやすいプロジェクト 国会事故調編 | |
| R200200046 | 土木学会東日本大震災アーカイブサイト | https://www.jsce.or.jp/library/page/co.shtml |
| R200200049 | 3がつ11にちをわすれないためにセンター (せんだいメディアテーク) | https://recorder311.smt.jp/use/ |
| R200200051 | 防災専門図書館蔵書 (全国市有物件災害共済会) | |
| R200200053 | 長岡市災害復興文庫 (長岡市歴史文書館) | |
| R200200060 | 福島原子力事故関連情報アーカイブ (日本原子力研究開発機構) | https://f-archive.jaea.go.jp/help.php?return=close#help2 |
| R200200061 | 東日本大震災アーカイブ宮城 | https://kioku.library.pref.miyagi.jp/ja-top-terms-of-use.html |
| R200200062 | 郡山震災アーカイブ | https://www.city.koriyama.lg.jp/soshiki/5/7431.html |
| R200200067 | 浦安震災アーカイブ (浦安市立図書館)（承継） | |
| R200200068 | 防災科学技術研究所自然災害情報室蔵書目録 | https://www.bosai.go.jp/about/use.html |
| R200200081 | みえ防災・減災アーカイブ (三重県・三重大学 みえ防災・減災センター) | https://midori.midimic.jp/terms |
| R200200086 | いわて震災津波アーカイブ～希望～ | https://iwate-archive.pref.iwate.jp/terms/ |
| R200200095 | 熊本災害デジタルアーカイブ | https://www.kumamoto-archive.jp/about-us |
| R200200097 | 岩手県の自然災害と東日本大震災に関する資料リポジトリ (岩手大学) | https://www.iwate-u.ac.jp/copyright.html |
| R200200100 | 3.11いわてNPOチラシアーカイブ (いわて連携復興センター) | https://www.ifc.jp/page/wp/about |
| R200200103 | 震災ライブラリーオンライン版 (東北大学附属図書館) | https://www.library.tohoku.ac.jp/copyright.html |
| R200200105 | 災害写真データベース（消防防災科学センター） | https://www.saigaichousa-db-isad.jp/drsdb_photo/photoSearch.do |
| R200200107 | 赤十字原子力災害情報センター デジタルアーカイブ（承継） | |
| R200200108 | 人と防災未来センター 資料室 | https://www.dri.ne.jp/policy/ |
| R200200113 | 青森震災アーカイブ（承継） | |
| R200200118 | 2014年神城断層地震震災アーカイブ | https://kamishiro.shinshu-bousai.jp/menu5/ |
| R200200119 | 東日本大震災・原子力災害伝承館 |
Copyright © 2013- National Diet Library. All Rights Reserved. 国立国会図書館 〒100-8924 東京都千代田区永田町1-10-1 電話：03-3581-2331（代表）