トップページ > ― 外部提供インタフェース(API)

― 外部提供インタフェース(API)

Table of Contents


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備考
検索用APISRUURLXML(RDF)https://kn.ndl.go.jp/api/sruひなぎくの簡易検索画面及び詳細検索画面からの検索と同じ検索が行えます。
検索用APIOpenSearchURLXML(RSS)https://kn.ndl.go.jp/api/opensearch
ハーベスト用APIOAI-PMHURLXMLhttps://kn.ndl.go.jp/api/oaipmh
各プロトコルの詳細は、プロトコル名のリンク先ページをご覧ください。

2. APIにより提供されるデータ

2.1. 提供データ

メタデータのみを提供しています。

2.2. メタデータの形式

ひなぎくが持つメタデータは、「国立国会図書館ダブリンコアメタデータ記述(DC-NDL)」を基に作成された「国立国会図書館東日本大震災アーカイブメタデータスキーマ」に従っています。
各プロトコルで返戻されるデータの形式も、「国立国会図書館東日本大震災アーカイブメタデータスキーマ」を基本形としています。

2.3. メタデータの更新時期

メタデータの更新は即時ではなく、日次のバッチ処理で更新されます。
このため、午前0時ちょうど(日付が変わった直後)にAPIを使用して、検索あるいはメタデータの収集を行った場合、前日のメタデータ更新が反映されていないメタデータが含まれる可能性があります。

2.4. メタデータ取得可能な提供元一覧

APIをご利用いただく際に、以下の提供元のリポジトリIDを指定することで検索対象を絞り込むことができます。全ての提供元について、検索用APIとハーベスト用APIの両方でメタデータを取得することできます。
*印を付している提供元については、当館でメタデータを作成しています。
各リポジトリの概要については、「検索対象データベース等一覧」をご覧ください。

リポジトリID提供元メタデータの提供者メタデータ二次利用条件(○は申請不要)
非営利目的営利目的
000004国立国会図書館雑誌記事索引当館
000007カレントアウェアネス・ポータル (国立国会図書館)当館要申請
000002国立国会図書館蔵書当館
100039国立国会図書館デジタルコレクション当館要申請
200001その他提供元 (個人)*当館
200004日本原子力研究開発機構図書館蔵書他機関
200006国立国会図書館インターネット資料収集保存事業 (WARP)当館
200015国会事故調 (東京電力福島原子力発電所事故調査委員会)*当館
200017ジャパン・プラットフォーム (JPF)*当館
200018ジュピター テレコム (J:COM)*当館
200020東京製本倶楽部*当館
200022東京電力ホールディングス*当館
200024国際協力NGOセンター (JANIC)*当館
200027その他提供元 (団体)*当館
200028国際交流基金*当館
200029東日本激災復興新聞 (日本建設新聞社)*当館
200030被災地斜め航空写真 (朝日航洋)*当館
200031東日本大震災の記録 (学校法人東北学院)他機関
200033NWEC災害復興支援女性アーカイブ (国立女性教育会館)他機関
200039福島県新地町被災写真 (新地町図書館)*当館
200040ICT地域の絆保存プロジェクト「東日本大震災を語り継ぐ」 (東松島市図書館)*当館
200041国立国会図書館*当館
200043青森震災アーカイブ他機関
200044市町村史に記された地震の記録 (埼玉県立熊谷図書館)他機関
200045わかりやすいプロジェクト 国会事故調編他機関
200046土木学会東日本大震災アーカイブサイト他機関
200048日本財団*当館
2000493がつ11にちをわすれないためにセンター (せんだいメディアテーク)他機関
200050政府インターネットテレビ*当館
200051防災専門図書館蔵書 (全国市有物件災害共済会)他機関
200052国土地理院*当館
200053長岡市災害復興文庫 (長岡市立中央図書館文書資料室)他機関
200058環境省*当館
200059防衛省*当館
200060福島原子力事故関連情報アーカイブ (日本原子力研究開発機構)他機関
200061東日本大震災アーカイブ宮城他機関
200062郡山震災アーカイブ他機関
200064防災科学技術研究所自然災害情報室*当館
200067浦安震災アーカイブ (浦安市立図書館)他機関
200068防災科学技術研究所自然災害情報室蔵書目録他機関
200069東海新報 (東海新報社)*当館
200070災害撮影 [事業活動と社会貢献] (株式会社パスコ)*当館
200072邑計画事務所*当館
200073大槌町水道事業所*当館
200074高田自動車学校*当館
200076〈盛岡〉設計同人*当館
200079国際航業*当館



Copyright © 2013- National Diet Library. All Rights Reserved.