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を追加しました。