CiNii Books - メタデータ・API - CiNii Books 図書・雑誌情報のJSON-LD(ベータ版)

 

CiNii Books図書・雑誌JSON-LDのフォーマット仕様について

※ベータ版のため、ご意見等をふまえフォーマット仕様に変更が生じる可能性があります。ご承知いただいたうえでご利用ください。

以下の書式のURIにアクセスすると、JSON-LD形式のデータを取得できます。取得できる情報は「CiNii Books 図書・雑誌情報のRDF」と同様です。図書と雑誌でフォーマットが異なります。
http://ci.nii.ac.jp/ncid/<ncid>.json(例:http://ci.nii.ac.jp/ncid/BB08796640.json

コンテントネゴシエーションに対応しています。JSON-LDのURIを指定しなくても、HTTPヘッダから判断してJSON-LDを返します。図書・雑誌詳細表示画面(例:http://ci.nii.ac.jp/ncid/BB08796640)において、HTTPリクエストヘッダのAcceptフィールドにて「application/json」 あるいは「application/ld+json」の指定が他のどの指定よりも優先度が高い場合には、JSON-LDのURIへ誘導します。

レスポンスの際のhttpヘッダに「Access-Control-Allow-Origin: *」を指定していますので、クロスドメイン間での非同期通信をご利用いただけます。

 

フォーマット仕様

 

図書書誌JSON-LD

No. タグ名 必須 内容 備考
第1階層 第2階層 第3階層 第4階層 第5階層
1 @context         オブジェクト 必須 文書のルート要素 "@context":{
"owl":"http://www.w3.org/2002/07/owl#",
"bibo":"http://purl.org/ontology/bibo/",
"foaf":"http://xmlns.com/foaf/0.1/",
"rdfs":"http://www.w3.org/2000/01/rdf-schema#",
"prism":"http://prismstandard.org/namespaces/basic/2.0/",
"cinii":"http://ci.nii.ac.jp/ns/1.0/",
"dc":"http://purl.org/dc/elements/1.1/",
"dcterms":"http://purl.org/dc/terms/"
},
2   owl         必須   http://www.w3.org/2002/07/owl#
3   bibo         必須   http://purl.org/ontology/bibo/
4   foaf         必須   http://xmlns.com/foaf/0.1/
5   rdfs         必須   http://www.w3.org/2000/01/rdf-schema#
6   prism         必須   http://prismstandard.org/namespaces/basic/2.0/
7   cinii         必須   http://ci.nii.ac.jp/ns/1.0/
8   dc         必須   http://purl.org/dc/elements/1.1/
9   dcterms         必須   http://purl.org/dc/terms/
10 @id           必須 図書書誌JSON-LDのURI 図書書誌JSON-LDのURIを表示(ただしappidのパラメータは除く)
"@id":"http://ci.nii.ac.jp/ncid/XX12345678.json",
11 @graph         配列 必須   配列の要素数は1
12   @id         必須 図書のURI 図書詳細表示画面のURIに「#entity」を付加したもの。
"@id":"http://ci.nii.ac.jp/ncid/XX12345678#entity",
13   @type         必須 図書を表す文字列 "@type":"bibo:Book",
14   foaf:isPrimaryTopicOf       オブジェクト 必須 図書書誌JSON-LDのURIに関する記述 図書書誌JSON-LDのURIを表示(ただしappidのパラメータは除く)
"foaf:isPrimaryTopicOf":{"@id":"http://ci.nii.ac.jp/ncid/XX12345678.json"},
15     @id       必須 図書書誌JSON-LDのURI  
16   dc:title       配列 必須 図書タイトルに関する記述 例:
"dc:title":[
{"@value":"Linked data : webをグローバルなデータ空間にする仕組み"},
{"@value":"Linked data : web オ グローバルナ データ クウカン ニ スル シクミ",
"@language":"ja-hrkt"}
],
17     @value       必須 図書タイトル、タイトルよみ  
18     @language         タイトルよみの言語 図書タイトルの場合―@language:なし
タイトルよみの場合―@language:必須。ko:ハングル または ja-hrkt:日本語フリガナ
19   dcterms:alternative       配列   別タイトル 複数ある場合は繰り返す。
20   dc:creator           責任表示 役割表示(「著」等)含む。
21   dc:publisher       配列   出版者 複数ある場合は繰り返す
22   dcterms:extent           ページ数/冊数  
23   cinii:size           大きさ  
24   dc:language         必須 本文の言語コード 本文が何語で書かれているかをコードで表示する。コードについては言語コード表を参照。
25   dc:date           出版年  
26   cinii:ncid         必須 書誌ID(NCID) NACSIS-CAT書誌ID
27   prism:edition           版表示  
28   cinii:ownerCount         必須 所蔵館数 対象の図書を所蔵する図書館の数
例:
"cinii:ownerCount":"63",
29   dcterms:medium       オブジェクト   資料種別に関する記述 例:
"dcterms:medium":{"dc:title":"録音資料(音楽)(CD)"},
30     dc:title       必須 資料種別  
31   foaf:maker       配列   著者に関する記述 例:
"foaf:maker":
[{"@id":"http://ci.nii.ac.jp/author/DA15839119#entity","@type":"foaf:Person","foaf:name":[{"@value":"大向, 一輝"},{"@value":"オオムカイ, イッキ","@language":"ja-hrkt"}]},
{"@id":"http://ci.nii.ac.jp/author/DA1649123X#entity","@type":"foaf:Person","foaf:name":[{"@value":"池谷, 瑠絵"},{"@value":"イケヤ, ルエ","@language":"ja-hrkt"}]}],
32     @id       必須 著者のURI 著者詳細ページのURIに「#entity」を付加したもの
33     @type       必須   固定:"foaf:Person"
34     foaf:name     配列 必須 著者名に関する記述  
35       @value     必須 著者名、著者名よみ 姓, 名
36       @language       著者名よみの言語 著者名の場合―@language:なし
著者名よみの場合―@language:必須。ko:ハングル または ja-hrkt:日本語フリガナ
37   bibo:owner       配列   所蔵館に関する記述 例:
"bibo:owner":
[{"@id":"http://ci.nii.ac.jp/library/FA008006","@type":"foaf:Organization","foaf:name":"関西外国語大学 図書館","rdfs:seeAlso":{"@id":"http://opac.kansaigaidai.ac.jp/webopac/ctlsrh.do?ncid=BB08796640"}},
{"@id":"http://ci.nii.ac.jp/library/FA022878","@type":"foaf:Organization","foaf:name":"奈良佐保短期大学図書館"},
38     @id       必須 所蔵館詳細ページのURI ko:ハングル または ja-hrkt:日本語フリガナ
39     @type       必須   固定:"foaf:Organization"
40     foaf:name       必須 所蔵館名  
41     rdfs:seeAlso     オブジェクト   所蔵館のOPAC URLに関する記述  
42       @id     必須 OPACURL OPACへのリンク先のURL(NCIDによって当該書誌のURLを指定)
43   bibo:lccn       配列   図書書誌のLCCN(米国議会図書館管理番号) 複数ある場合は繰り返す。
例:
"bibo:lccn":["84009674","82008292"],
44   rdfs:seeAlso       配列   LCCN Permalinkに関する記述 複数ある場合は繰り返す。
例:
"rdfs:seeAlso":[{"@id":"http://lccn.loc.gov/84009674"},
{"@id":"http://lccn.loc.gov/82008292"}],
45     @id       必須 LCCN PermalinkのURI LCCN Permalinkの該当ページのURI。http://lccn.loc.gov/<LCCN>
46   dcterms:hasFormat           全文データリンク  
47     @id       必須 全文データURL  
48     dc:title         巻号  
49     dc:date         発行日  
50   cinii:contentOfWorks       配列   内容著作注記 図書の構成部分である著作単位に関する記述。
例:
"cinii:contentOfWorks":["1: 邪宗門ノート","思ひ出ノート","2: 黒い皮ノート","桐の花ノート","三崎ノート"],
51   foaf:topic       配列   件名に関する記述 件名が複数ある場合は繰り返す。
例:
"foaf:topic":[{"@id":"http://ci.nii.ac.jp/books/search?q=%E6%83%85%E5%A0%B1%E5%8C%96%E7%A4%BE%E4%BC%9A","dc:title":"情報化社会"},
{"@id":"http://ci.nii.ac.jp/books/search?q=%E3%82%A4%E3%83%B3%E3%82%BF%E3%83%BC%E3%83%8D%E3%83%83%E3%83%88","dc:title":"インターネット"}],
52     @id       必須 件名のURI 件名をキーワードとして検索するときのURI
53     dc:title       必須 件名  
54   dcterms:isPartOf       配列   親書誌に関する記述 親書誌(シリーズ名)が複数ある場合は繰り返す。
例:
"dcterms:isPartOf":[{"@id":"http://ci.nii.ac.jp/ncid/BN06190301#entity","dc:title":"丸善ライブラリー, 381 . 情報研シリーズ||ジョウホウケン シリーズ ; 15"}],
55     @id       必須 親書誌の著作のURI 親書誌(シリーズ名)のURIに「#entity」を付加したもの
56     dc:title       必須 親書誌のタイトル シリーズの中での番号等も含む
57   dcterms:hasPart       配列   巻冊次に関する記述 複数ある場合は繰り返す。
例:
"dcterms:hasPart":[{"@id":"urn:isbn:4642005013","dc:title":"第1巻"},
58     @id         ISBN urn:isbn:<ISBN>
59     dc:title         巻冊次  
 

雑誌書誌JSON-LD

No. タグ名 必須 内容 備考
第1階層 第2階層 第3階層 第4階層 第5階層
1 @context         オブジェクト 必須 文書のルート要素 "@context":{
"owl":"http://www.w3.org/2002/07/owl#",
"bibo":"http://purl.org/ontology/bibo/",
"foaf":"http://xmlns.com/foaf/0.1/",
"rdfs":"http://www.w3.org/2000/01/rdf-schema#",
"prism":"http://prismstandard.org/namespaces/basic/2.0/",
"cinii":"http://ci.nii.ac.jp/ns/1.0/",
"dc":"http://purl.org/dc/elements/1.1/",
"dcterms":"http://purl.org/dc/terms/"
},
2   owl         必須   http://www.w3.org/2002/07/owl#
3   bibo         必須   http://purl.org/ontology/bibo/
4   foaf         必須   http://xmlns.com/foaf/0.1/
5   rdfs         必須   http://www.w3.org/2000/01/rdf-schema#
6   prism         必須   http://prismstandard.org/namespaces/basic/2.0/
7   cinii         必須   http://ci.nii.ac.jp/ns/1.0/
8   dc         必須   http://purl.org/dc/elements/1.1/
9   dcterms         必須   http://purl.org/dc/terms/
10 @id           必須 雑誌書誌JSON-LDのURI 雑誌書誌JSON-LDのURIを表示(ただしappidのパラメータは除く)
"@id":"http://ci.nii.ac.jp/ncid/XX12345678.json",
11 @graph         配列 必須   配列の要素数は1
12   @id         必須 雑誌のURI 雑誌詳細表示画面のURIに「#entity」を付加したもの。
"@id":"http://ci.nii.ac.jp/ncid/XX12345678#entity",
13   @type         必須 雑誌を表す文字列 "@type":"bibo:Journal",
14   foaf:isPrimaryTopicOf       オブジェクト 必須 雑誌書誌JSON-LDのURIに関する記述 雑誌書誌JSON-LDのURIを表示(ただしappidのパラメータは除く)
"foaf:isPrimaryTopicOf":{"@id":"http://ci.nii.ac.jp/ncid/XX12345678.json"},
15     @id       必須 雑誌書誌JSON-LDのURI  
16   dc:title       配列 必須 雑誌タイトルに関する記述 例:
"dc:title":
[{"@value":"情報処理学会論文誌"},
{"@value":"ジョウホウ ショリ ガッカイ ロンブンシ","@language":"ja-hrkt"}],
17     @value       必須 雑誌タイトル、タイトルよみ  
18     @language         タイトルよみの言語 雑誌タイトルの場合―@language:なし
タイトルよみの場合―@language:必須。ko:ハングル または ja-hrkt:日本語フリガナ
19   dcterms:alternative       配列   別タイトル 複数ある場合は繰り返す。
20   dc:creator           責任表示 役割表示(「著」等)含む。
21   dc:publisher       配列   出版者 複数ある場合は繰り返す
22   dcterms:extent           ページ数/冊数  
23   cinii:size           大きさ  
24   dc:language         必須 本文の言語コード 本文が何語で書かれているかをコードで表示する。コードについては言語コード表を参照。
25   dc:date           出版年  
26   cinii:ncid         必須 書誌ID(NCID) NACSIS-CAT書誌ID
27   prism:edition           版表示  
28   cinii:ownerCount         必須 所蔵館数 対象の雑誌を所蔵する図書館の数
例:
"cinii:ownerCount":"63",
29   dcterms:medium       オブジェクト   資料種別に関する記述 例:
"dcterms:medium":{"dc:title":"録音資料(音楽)(CD)"},
30     dc:title       必須 資料種別  
31   foaf:maker       配列   著者に関する記述 例:
"foaf:maker":
[{"@id":"http://ci.nii.ac.jp/author/DA15839119#entity","@type":"foaf:Person","foaf:name":[{"@value":"大向, 一輝"},{"@value":"オオムカイ, イッキ","@language":"ja-hrkt"}]},
{"@id":"http://ci.nii.ac.jp/author/DA1649123X#entity","@type":"foaf:Person","foaf:name":[{"@value":"池谷, 瑠絵"},{"@value":"イケヤ, ルエ","@language":"ja-hrkt"}]}],
32     @id         著者のURI 著者詳細ページのURIに「#entity」を付加したもの
33     @type       必須   固定:"foaf:Person"
34     foaf:name     配列 必須 著者名に関する記述  
35       @value     必須 著者名、著者名よみ 姓, 名
36       @language       著者名よみの言語 著者名の場合―@language:なし
著者名よみの場合―@language:必須。ko:ハングル または ja-hrkt:日本語フリガナ
37   bibo:owner       配列   所蔵館に関する記述 例:
"bibo:owner":
[{"@id":"http://ci.nii.ac.jp/library/FA008006","@type":"foaf:Organization","foaf:name":"関西外国語大学 図書館","rdfs:seeAlso":{"@id":"http://opac.kansaigaidai.ac.jp/webopac/ctlsrh.do?ncid=BB08796640"}},
{"@id":"http://ci.nii.ac.jp/library/FA022878","@type":"foaf:Organization","foaf:name":"奈良佐保短期大学図書館"},
38     @id       必須 所蔵館詳細ページのURI  
39     @type       必須   固定:"foaf:Organization"
40     foaf:name       必須 所蔵館名  
41     rdfs:seeAlso     オブジェクト   所蔵館のOPAC URLに関する記述  
42       @id     必須 OPAC URL OPACへのリンク先のURL(NCIDによって当該書誌のURLを指定)
43   bibo:lccn       配列   雑誌書誌のLCCN(米国議会図書館管理番号) 複数ある場合は繰り返す。
例:
"bibo:lccn":["84009674","82008292"],
44   rdfs:seeAlso       配列   LCCN Permalinkに関する記述 複数ある場合は繰り返す。
例:
"rdfs:seeAlso":[{"@id":"http://lccn.loc.gov/84009674"},
{"@id":"http://lccn.loc.gov/82008292"}],
45     @id       必須 LCCN PermalinkのURI LCCN Permalinkの該当ページのURI。http://lccn.loc.gov/<LCCN>
46   dcterms:hasFormat           全文データリンク  
47     @id       必須 全文データURL  
48     dc:title         巻号  
49     dc:date         発行日  
50   cinii:volumeYear           巻次・年月次  
51   prism:issn           ISSN  
52   cinii:familyid           雑誌変遷ファミリーID  
53   dc:relation       配列   変遷前/後誌に関する記述 例:
"dc:relation":
[{"@id":"http://ci.nii.ac.jp/ncid/AA00700121#entity","dc:title":"Journal of information processing / Information Processing Society of Japan"},
{"@id":"http://ci.nii.ac.jp/ncid/AA12317677#entity","dc:title":"情報処理学会論文誌 : 論文誌ジャーナル / 情報処理学会 = IPSJ journal / Information Processing Society of Japan"}],
54     @id       必須 変遷前/後誌の雑誌URI 雑誌書誌詳細ページのURIに「#entity」を付加したもの。
55     dc:title       必須 変遷前/後誌のタイトル  
 

改訂履歴

2013年4月以降の改訂履歴をご確認いただけます。

2017年8月17日

  • フォーマット仕様を修正しました。
    • dcterms:hasFormatで全文データリンクを表す情報を追加しました。
    • owl:sameAsを削除しました。(雑誌書誌RDFのみ)

2015年11月5日

  • フォーマット仕様を修正しました。
    • dcterms:extentでページ数/冊数を表す情報を追加しました。
    • cinii:sizeで大きさを表す情報を追加しました。

2015年3月13日

  • フォーマット仕様を修正しました。
    • @typeで雑誌記事・論文を表す情報を追加しました。

2013年10月11日

  • クロスドメイン間の非同期通信に対応しました。
  • 図書・雑誌情報のJSON-LDのAPIを追加しました。