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

 

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

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

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

コンテントネゴシエーションに対応しています。JSON-LDのURIを指定しなくても、HTTPヘッダから判断してJSON-LDを返します。図書・雑誌詳細表示画面(例:https://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":"https://ci.nii.ac.jp/ncid/XX12345678.json",
11 @graph         配列 必須   配列の要素数は1
12   @id         必須 図書のURI 図書詳細表示画面のURIに「#entity」を付加したもの。
"@id":"https://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":"https://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     @value         出版者名
23     cinii:publisherRole         出版等の役割表示 出力される値は以下の4つ。
distribution
manufacture
production
copyright_notice_date
24   dcterms:extent           ページ数/冊数  
25   cinii:size           大きさ  
26   dc:language         必須 本文の言語コード 本文が何語で書かれているかをコードで表示する。コードについては言語コード表を参照。
27   dc:date           出版年  
28   cinii:ncid         必須 書誌ID(NCID) NACSIS-CAT書誌ID
29   prism:edition           版表示  
30   cinii:ownerCount         必須 所蔵館数 対象の図書を所蔵する図書館の数
例:
"cinii:ownerCount":"63",
31   dcterms:medium       オブジェクト   資料種別に関する記述 例:
"dcterms:medium":{"dc:title":"録音資料(音楽)(CD)"},
32     dc:title       必須 資料種別  
33   foaf:maker       配列   著者に関する記述 例:
"foaf:maker":
[{"@id":"https://ci.nii.ac.jp/author/DA15839119#entity","@type":"foaf:Person","foaf:name":[{"@value":"大向, 一輝"},{"@value":"オオムカイ, イッキ","@language":"ja-hrkt"}]},
{"@id":"https://ci.nii.ac.jp/author/DA1649123X#entity","@type":"foaf:Person","foaf:name":[{"@value":"池谷, 瑠絵"},{"@value":"イケヤ, ルエ","@language":"ja-hrkt"}]}],
34     @id         著者のURI 著者詳細ページのURIに「#entity」を付加したもの
35     @type           固定:"foaf:Person"
36     foaf:name     配列   著者名に関する記述  
37       @value       著者名、著者名よみ 姓, 名
38       @language       著者名よみの言語 著者名の場合―@language:なし
著者名よみの場合―@language:必須。ko:ハングル または ja-hrkt:日本語フリガナ
39   bibo:owner       配列   所蔵館に関する記述 例:
"bibo:owner":
[{"@id":"https://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":"https://ci.nii.ac.jp/library/FA022878","@type":"foaf:Organization","foaf:name":"奈良佐保短期大学図書館"},
40     @id         所蔵館詳細ページのURI 所蔵館詳細ページのURIに「#entity」を付加したもの
41     @type           固定:"foaf:Organization"
42     foaf:name         所蔵館名  
43     rdfs:seeAlso     オブジェクト   所蔵館のOPAC URLに関する記述  
44       @id     必須 OPACURL OPACへのリンク先のURL(NCIDによって当該書誌のURLを指定)
45   bibo:lccn       配列   図書書誌のLCCN(米国議会図書館管理番号) 複数ある場合は繰り返す。
例:
"bibo:lccn":["84009674","82008292"],
46   rdfs:seeAlso       配列   LCCN Permalinkに関する記述 複数ある場合は繰り返す。
例:
"rdfs:seeAlso":[{"@id":"https://lccn.loc.gov/84009674"},
{"@id":"https://lccn.loc.gov/82008292"}],
47     @id       必須 LCCN PermalinkのURI LCCN Permalinkの該当ページのURI。https://lccn.loc.gov/<LCCN>
48   dcterms:hasFormat       配列   全文データリンク  
49     @id       必須 全文データURL  
50     dc:title         巻号  
51     dc:date         発行日  
52   prism:publicationDate       配列   出版年月等  
53   cinii:note       配列   注記  
54   dc:subject       配列   分類  
55   cinii:relation       配列   並立書誌のパーマリンク  
56     @id       必須   https://ci.nii.ac.jp/ncid/XX12345678に「#entity」を付加したもの
57     dc:title       必須   並立書誌タイトル
58     cinii:ncid         並立書誌ID 並立書誌の書誌ID
59   cinii:contentOfWorks       配列   内容著作注記 図書の構成部分である著作単位に関する記述。
例:
"cinii:contentOfWorks":["1: 邪宗門ノート","思ひ出ノート","2: 黒い皮ノート","桐の花ノート","三崎ノート"],
60   foaf:topic       配列   件名に関する記述 件名が複数ある場合は繰り返す。
例:
"foaf:topic":[{"@id":"https://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":"https://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":"インターネット"}],
61     @id         件名のURI 件名をキーワードとして検索するときのURI
62     dc:title         件名  
63   dcterms:isPartOf       配列   親書誌に関する記述 親書誌(シリーズ名)が複数ある場合は繰り返す。
例:
"dcterms:isPartOf":[{"@id":"https://ci.nii.ac.jp/ncid/BN06190301#entity","dc:title":"丸善ライブラリー, 381 . 情報研シリーズ||ジョウホウケン シリーズ ; 15"}],
64     @id         親書誌の著作のURI 親書誌(シリーズ名)のURIに「#entity」を付加したもの
65     dc:title         親書誌のタイトル シリーズの中での番号等も含む
66     @type           固定:"bibo:Book"
67   dcterms:hasPart       配列   巻冊次に関する記述 複数ある場合は繰り返す。
例:
"dcterms:hasPart":[{"@id":"urn:isbn:4642005013","dc:title":"第1巻"},
68     @id         ISBN urn:isbn:<ISBN>
69     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":"https://ci.nii.ac.jp/ncid/XX12345678.json",
11 @graph         配列 必須   配列の要素数は1
12   @id         必須 雑誌のURI 雑誌詳細表示画面のURIに「#entity」を付加したもの。
"@id":"https://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":"https://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     @value         出版者名
23     cinii:publisherRole         出版等の役割表示 出力される値は以下の4つ。
distribution
manufacture
production
copyright_notice_date
24   dcterms:extent           ページ数/冊数  
25   cinii:size           大きさ  
26   dc:language         必須 本文の言語コード 本文が何語で書かれているかをコードで表示する。コードについては言語コード表を参照。
27   dc:date           出版年  
28   cinii:ncid         必須 書誌ID(NCID) NACSIS-CAT書誌ID
29   prism:edition           版表示  
30   cinii:ownerCount         必須 所蔵館数 対象の雑誌を所蔵する図書館の数
例:
"cinii:ownerCount":"63",
31   dcterms:medium       オブジェクト   資料種別に関する記述 例:
"dcterms:medium":{"dc:title":"録音資料(音楽)(CD)"},
32     dc:title       必須 資料種別  
33   foaf:maker       配列   著者に関する記述 例:
"foaf:maker":
[{"@id":"https://ci.nii.ac.jp/author/DA15839119#entity","@type":"foaf:Person","foaf:name":[{"@value":"大向, 一輝"},{"@value":"オオムカイ, イッキ","@language":"ja-hrkt"}]},
{"@id":"https://ci.nii.ac.jp/author/DA1649123X#entity","@type":"foaf:Person","foaf:name":[{"@value":"池谷, 瑠絵"},{"@value":"イケヤ, ルエ","@language":"ja-hrkt"}]}],
34     @id         著者のURI 著者詳細ページのURIに「#entity」を付加したもの
35     @type       必須   固定:"foaf:Person"
36     foaf:name     配列 必須 著者名に関する記述  
37       @value     必須 著者名、著者名よみ 姓, 名
38       @language       著者名よみの言語 著者名の場合―@language:なし
著者名よみの場合―@language:必須。ko:ハングル または ja-hrkt:日本語フリガナ
39   bibo:owner       配列   所蔵館に関する記述 例:
"bibo:owner":
[{"@id":"https://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":"https://ci.nii.ac.jp/library/FA022878","@type":"foaf:Organization","foaf:name":"奈良佐保短期大学図書館"},
40     @id       必須 所蔵館詳細ページのURI  
41     @type       必須   固定:"foaf:Organization"
42     foaf:name       必須 所蔵館名  
43     rdfs:seeAlso     オブジェクト   所蔵館のOPAC URLに関する記述  
44       @id     必須 OPAC URL OPACへのリンク先のURL(NCIDによって当該書誌のURLを指定)
45   bibo:lccn       配列   雑誌書誌のLCCN(米国議会図書館管理番号) 複数ある場合は繰り返す。
例:
"bibo:lccn":["84009674","82008292"],
46   rdfs:seeAlso       配列   LCCN Permalinkに関する記述 複数ある場合は繰り返す。
例:
"rdfs:seeAlso":[{"@id":"https://lccn.loc.gov/84009674"},
{"@id":"https://lccn.loc.gov/82008292"}],
47     @id       必須 LCCN PermalinkのURI LCCN Permalinkの該当ページのURI。https://lccn.loc.gov/<LCCN>
48   dcterms:hasFormat           全文データリンク  
49     @id       必須 全文データURL  
50     dc:title         巻号  
51     dc:date         発行日  
52   prism:publicationDate       配列   出版年月等  
53   cinii:note       配列   注記  
54   cinii:volumeYear           巻次・年月次  
55   prism:issn           ISSN  
56   cinii:familyid           雑誌変遷ファミリーID  
57   dc:relation       配列   変遷前/後誌に関する記述 例:
"dc:relation":
[{"@id":"https://ci.nii.ac.jp/ncid/AA00700121#entity","dc:title":"Journal of information processing / Information Processing Society of Japan"},
{"@id":"https://ci.nii.ac.jp/ncid/AA12317677#entity","dc:title":"情報処理学会論文誌 : 論文誌ジャーナル / 情報処理学会 = IPSJ journal / Information Processing Society of Japan"}],
58     @id       必須 変遷前/後誌の雑誌URI 雑誌書誌詳細ページのURIに「#entity」を付加したもの。
59     dc:title       必須 変遷前/後誌のタイトル  
 

改訂履歴

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

2024年11月11日

  • フォーマット仕様を修正しました。
    • dc:publisherのcinii:publisherRole属性で出版等の役割表示を表す情報を追加しました。

2020年8月21日

  • フォーマット仕様を修正しました。
    • cinii:relationで並立書誌を表す情報を追加しました。(図書書誌JSON-LDのみ)

2018年1月18日

  • フォーマット仕様を修正しました。
    • dcterms:hasFormatで出版年月等を表す情報を追加しました。
    • cinii:noteで注記を表す情報を追加しました。
    • dc:subjectで分類を表す情報を追加しました。(図書書誌JSON-LDのみ)

2017年8月17日

  • フォーマット仕様を修正しました。
    • prism:publicationDateで全文データリンクを表す情報を追加しました。
    • owl:sameAsを削除しました。

2015年11月5日

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

2015年3月13日

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

2013年10月11日

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