トップ>OAI-PMHの仕様について

OAI-PMHの仕様について

OAI-PMHの仕様は以下のとおりです。なお、基本仕様はOpen Archives Initiativeのページをご参照ください。

※   2012年12月27日から、URLが変更になりました。

基本情報(Identify返戻内容)

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

 

メタデータ形式

metadataPrefixschemametadataNamespace
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:reseach_guide)のみ指定可能。

resumptionToken フロー制御(連続したメタデータ取得)時に使用するトークン

 

リクエストとパラメータの関係
リクエストパラメータ
identifiermetadataPrefixfromuntilsetresumptionToken
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:164144&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:research_guide&from=2010-05-01&until=2010-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:research_guide&from=2010-05-01
  • ListSets
    http://gw.rnavi.ndl.go.jp/oaipmh/request?verb=ListSets
  • 国立国会図書館
  • NDL-OPAC 国立国会図書館蔵書検索・申込システム
  • 国立国会図書館サーチ
  • 国立国会図書館デジタルコレクション
  • ひなぎく
  • レファレンス協同データベース
  • 本の万華鏡