リサーチ・ナビのOAI-PMHの仕様について

OAI-PMHの仕様は以下のとおりです。なお、基本仕様はOpen Archives Initiativeのページ外部サイトへのリンクをご参照ください。

基本情報(Identify返戻内容)

タグ名 内容 返戻内容
repositoryName 名称 RESEARCH NAVI
baseURL ベースURL http://gw.rnavi.ndl.go.jp/oaipmh/request
protocolVersion サポートしているOAI-PMHバージョン 2.0
adminEmail 管理者Emailアドレス rnaviアットマークエヌディーエルピリオドジーオーピリオドジェーピー
earliestDatestamp 日時スタンプの保証下限 2001-01-01T00:00:00Z
deletedRecord 削除ポリシー transient
granularity 最も細かいデータ収集単位 yyyy-MM-ddThh:mm:ssZ

メタデータ形式

metadataPrefix schema metadataNamespace
dcndl_porta http://porta.ndl.go.jp/schema/dcndl_porta.xsd http://ndl.go.jp/dcndl/dcndl_porta/
oai_dc http://www.openarchives.org/OAI/2.0/oai_dc.xsd http://www.openarchives.org/OAI/2.0/oai_dc/

リクエスト形式

http://gw.rnavi.ndl.go.jp/oaipmh/request?verb=[リクエストの種類]&[パラメータを指定]

リクエストの種類
リクエスト リクエスト内容
GetRecord 個別データを検索して取得する
Identify リポジトリに関する情報を取得する
ListIdentifiers メタデータのヘッダ部のみを取得する
ListMetadataFormats リポジトリがサポートするメタデータのフォーマット一覧を取得する
ListRecords メタデータのリストを取得する
ListSets リポジトリがサポートするセットの一覧を取得する
パラメータの種類
パラメータ 意味
identifier データ毎のユニーク識別子
metadataPrefix メタデータのフォーマット ※dcndl_porta または oai_dcを指定可能。
from 期間(datestamp)の下限値
until 期間(datestamp)の上限値
set 収集対象とする setSpec (カテゴリー) ※rnavi:jpのみ指定可能。
resumptionToken フロー制御(連続したメタデータ取得)時に使用するトークン
リクエストとパラメータの関係
リクエスト パラメータ
identifier metadataPrefix from until set resumptionToken
GetRecord - - - -
Identify - - - - - -
ListIdentifiers -
ListMetadataFormats - - - - -
ListRecords -
ListSets - - - - -

※ ◎=必須、○=任意

返戻件数

ListIdentifiers、ListRecords、ListSetsにおいて一度に返戻されるデータの件数は100件である。101件以降を取得したい場合には、100件を取得した際に通知されるresumptionTokenを指定してリクエストする。

リクエスト例

GetRecord
http://gw.rnavi.ndl.go.jp/oaipmh/request?verb=GetRecord&identifier=oai:gateway:495155&metadataPrefix=dcndl_porta
Identify
http://gw.rnavi.ndl.go.jp/oaipmh/request?verb=Identify
ListIdentifiers
http://gw.rnavi.ndl.go.jp/oaipmh/request?verb=ListIdentifiers&metadataPrefix=dcndl_porta&set=rnavi:jp&from=2022-05-01&until=2022-05-31
ListMetadataFormats
http://gw.rnavi.ndl.go.jp/oaipmh/request?verb=ListMetadataFormats
ListRecords
http://gw.rnavi.ndl.go.jp/oaipmh/request?verb=ListRecords&metadataPrefix=dcndl_porta&set=rnavi:jp&from=2022-05-01
ListSets
http://gw.rnavi.ndl.go.jp/oaipmh/request?verb=ListSets