CiNii Articles論文情報JSON-LDのフォーマット仕様について
※ベータ版のため、ご意見等をふまえフォーマット仕様に変更が生じる可能性があります。ご承知いただいたうえでご利用ください。
以下の書式のURIにアクセスすると、JSON-LD形式のデータを取得できます。取得できる情報は「CiNii Articles論文情報のRDF」と同様です。「論文情報」、「著者に関する情報」すべて出力します。
https://ci.nii.ac.jp/naid/<naid>.json(例:https://ci.nii.ac.jp/naid/110009544496.json)
コンテントネゴシエーションに対応しています。JSON-LDのURIを指定しなくても、HTTPヘッダから判断してJSON-LDを返します。論文詳細表示画面(例:https://ci.nii.ac.jp/naid/110009544496)において、HTTPリクエストヘッダのAcceptフィールドにて「application/json」 あるいは「application/ld+json」の指定が他のどの指定よりも優先度が高い場合には、JSON-LDのURIへ誘導します。
レスポンスの際のhttpヘッダに「Access-Control-Allow-Origin: *」を指定していますので、クロスドメイン間での非同期通信をご利用いただけます。
フォーマット仕様
論文情報
No. | タグ名 | 型 | 必須 | 内容 | 備考 | ||||
第1階層 | 第2階層 | 第3階層 | 第4階層 | 第5階層 | |||||
1 | @context | オブジェクト | 必須 | 文書のルート要素 | "@context":{ "rdfs":"http://www.w3.org/2000/01/rdf-schema#", "dc":"http://purl.org/dc/elements/1.1/", "dcterms":"http://purl.org/dc/terms/", "foaf":"http://xmlns.com/foaf/0.1/", "prism":"http://prismstandard.org/namespaces/basic/2.0/", "con":"http://www.w3.org/2000/10/swap/pim/contact#", "cinii":"http://ci.nii.ac.jp/ns/1.0/", "bibo":"http://purl.org/ontology/bibo/"}, |
||||
2 | rdfs | 必須 | http://www.w3.org/2000/01/rdf-schema# | ||||||
3 | dc | 必須 | http://purl.org/dc/elements/1.1/ | ||||||
4 | dcterms | 必須 | http://purl.org/dc/terms/ | ||||||
5 | foaf | 必須 | http://xmlns.com/foaf/0.1/ | ||||||
6 | prism | 必須 | http://prismstandard.org/namespaces/basic/2.0/ | ||||||
7 | con | 必須 | http://www.w3.org/2000/10/swap/pim/contact# | ||||||
8 | cinii | 必須 | http://ci.nii.ac.jp/ns/1.0/ | ||||||
9 | bibo | 必須 | http://purl.org/ontology/bibo/ | ||||||
10 | @id | 必須 | 論文書誌JSON-LDのURI | 論文書誌JSON-LDのURIを表示(ただしappidのパラメータは除く) "@id":"https://ci.nii.ac.jp/naid/1234567890.json", |
|||||
11 | @graph | 配列 | 必須 | 配列の要素数は1 | |||||
12 | @id | 論文のURI | 論文詳細表示画面のURIに「#article」を付加したもの。 "@id":"https://ci.nii.ac.jp/naid/1234567890#article", |
||||||
13 | @type | 記事・論文を示す固定文字列 | "@type":"bibo:Article", | ||||||
14 | foaf:isPrimaryTopicOf | オブジェクト | 論文書誌JSON-LDのURIに関する記述 | 論文書誌JSON-LDのURIを表示(ただしappidのパラメータは除く) "foaf:isPrimaryTopicOf":{"@id":"https://ci.nii.ac.jp/naid/1234567890.json"}, |
|||||
15 | @id | 論文書誌JSON-LDのURI | |||||||
16 | dc:title | 配列 | タイトルに関する記述 | 例: "dc:title": [ {"@value":"CiNii Articlesのシステムデザインとデータモデル(<特集>データベース構築の今)"}, {"@value":"System design and data modeling of CiNii articles(<Special feature>Database design and construction)", "@language":"en"} ], |
|||||
17 | @value | タイトル:日本語、タイトル:英語 | |||||||
18 | @language | タイトルの言語 | タイトル:日本語の場合―@language:なし タイトル:英語の場合―@language:必須。en:英語 |
||||||
19 | dc:creator | 配列 | 著者に関する記述 | 役割表示(「著」等)含む。複数ある場合は繰り返す 例: "dc:creator": [ [{"@value":"吉田 幸苗"},{"@value":"YOSHIDA Yukinae","@language":"en"}], [{"@value":"高橋 菜奈子"},{"@value":"TAKAHASHI Nanako","@language":"en"}], [{"@value":"木下 克之"},{"@value":"KINOSHITA Katsuyuki","@language":"en"}], [{"@value":"尾城 孝一"},{"@value":"OJIRO Koichi","@language":"en"}] ], | |||||
20 | @value | 著者名:日本語、著者名:英語 | |||||||
21 | @language | 著者名の言語 | 著者名:日本語の場合―@language:なし 著者名:英語の場合―@language:必須。en:英語 |
||||||
22 | dc:publisher | 配列 | 出版者に関する記述 | 複数ある場合は繰り返す 例: "dc:publisher":[ {"@value":"社団法人人工知能学会"}, {"@value":"The Japanese Society for Artificial Intelligence","@language":"en"} ], |
|||||
23 | @value | 出版者名:日本語、出版者名:英語 | |||||||
24 | @language | 出版者名の言語 | 出版者名:日本語の場合―@language:なし 出版者名:英語の場合―@language:必須。en:英語 |
||||||
25 | prism:publicationName | 配列 | 刊行物名に関する記述 | 例: "prism:publicationName":[ {"@value":"人工知能学会誌"}, {"@value":"Journal of Japanese Society for Artificial Intelligence","@language":"en"} ], |
|||||
26 | @value | 刊行物名:日本語、刊行物名:英語 | |||||||
27 | @language | 刊行物名の言語 | 刊行物名:日本語の場合―@language:なし 刊行物名:英語の場合―@language:必須。en:英語 |
||||||
28 | prism:issn | ISSN | |||||||
29 | prism:volume | 巻 | |||||||
30 | prism:number | 号(通号) | |||||||
31 | prism:startingPage | 開始ページ | |||||||
32 | prism:endingPage | 終了ページ | |||||||
33 | prism:pageRange | ページ範囲 | |||||||
34 | prism:publicationDate | 出版年月日 | W3CDTF表記 | ||||||
35 | dc:description | 配列 | 論文の抄録に関する記述 | 例: "dc:description":[ {"@value":"<抄録:日本語>"}, {"@value":"<抄録:英語>","@language":"en"} ], |
|||||
36 | @value | 抄録:日本語、抄録:英語 | |||||||
37 | @language | 抄録の言語 | 抄録:日本語の場合―@language:なし 抄録:英語の場合―@language:必須。en:英語 |
||||||
38 | foaf:topic | 配列 | キーワードに関する記述 | キーワードが複数ある場合は繰り返す。例:"foaf:topic":[ { "@id":"https://ci.nii.ac.jp/keyword/システムデザイン", "dc:title":[{"@value":"システムデザイン"}] }, { "@id":"https://ci.nii.ac.jp/keyword/検索エンジン", "dc:title":[{"@value":"検索エンジン"}] }, { "@id":"https://ci.nii.ac.jp/keyword/system+design", "dc:title":[{"@value":"system design","@language":"en"}] }, { "@id":"https://ci.nii.ac.jp/keyword/search+engine", "dc:title":[{"@value":"search engine","@language":"en"}] } ] |
|||||
39 | @id | キーワードのURI | キーワードを検索するときのURL。キーワード文字列内に半角スペースが存在する場合は「+」で置換される | ||||||
40 | dc:title | 配列 | |||||||
41 | @value | キーワード:日本語、キーワード:英語 | |||||||
42 | @language | キーワードの言語 | キーワード:日本語の場合―@language:なし キーワード:英語の場合―@language:必須。en:英語 |
||||||
43 | dc:date | 出版年月日 | prism:publicationDateと同じ内容 | ||||||
44 | cinii:naid | 論文のNAID | CiNii Articles内での論文のID | ||||||
45 | cinii:ncid | 収録誌のNCID | 収録誌のNACSIS-CAT書誌ID | ||||||
46 | cinii:ndljpi | 論文のNDLID | 国立国会図書館の記事登録ID | ||||||
47 | dc:language | 本文の言語コード | |||||||
48 | dc:source | 配列 | 収録元データベースに関する記述 | 複数ある場合は列挙する 例: "dc:source":[ {"@value":"NDL"}, {"@value":"NII-ELS"} ], |
|||||
49 | @value | 配列 | 収録元データベースの名称 | ||||||
50 | cinii:references | 参考文献の件数 | |||||||
51 | cinii:citedBy | 被引用文献の件数 | |||||||
52 | dcterms:isPartOf | オブジェクト | 収録誌に関する記述 | 例:"dcterms:isPartOf":{"@id":"https://ci.nii.ac.jp/ncid/AN10005857#entity","dc:title":"情報の科学と技術"}, | |||||
53 | @id | 収録誌のURI | CiNii Booksの雑誌詳細表示画面のURIに「#entity」を付加したもの | ||||||
54 | dc:title | 収録誌タイトル | |||||||
55 | rdfs:seeAlso | 配列 | 外部リンクに関する記述 | 複数ある場合は繰り返す。 例: "rdfs:seeAlso":[ {"@id":"http://id.ndl.go.jp/bib/025041670", "dc:title":"NDL-OPAC - 国立国会図書館でさがす"}, {"@id":"https://jlc.jst.go.jp/DN/JST.JSTAGE/johokanri/56.582?from=CiNii", "dc:title":"J-STAGEで読む・さがす"}, ], |
|||||
56 | @id | 外部リンクのリンク先URL | |||||||
57 | dc:title | 外部リンクのリソース種別 | 機関リポジトリ、J-STAGE、CrossRef、医中誌Web、NDL-OPAC 等 | ||||||
58 | prism:doi | DOI | |||||||
59 | foaf:depiction | オブジェクト | この論文を表す画像に関する記述 | 例: "foaf:depiction":{ "@id":"http://ci.nii.ac.jp/pdfthumbnail/11/1100/110009/110009662002.jpg", "@type":"foaf:Image" }, |
|||||
60 | @id | サムネイル画像のURL | 論文詳細ページに表示している本文のサムネイル画像URL | ||||||
61 | @type | 固定"foaf:Image" |
著者に関する情報
No. | タグ名 | 型 | 必須 | 内容 | 備考 | |||||
第1階層 | 第2階層 | 第3階層 | 第4階層 | 第5階層 | 第6階層 | |||||
62 | foaf:maker | 配列 | 著者に関する記述 | 著者数分繰り返す。 例: "foaf:maker": [ { "@id": "https://ci.nii.ac.jp/nrid/9000002411010#me", "@type": "foaf:Person", "foaf:name": [{"@value": "吉田 幸苗"},{"@value": "YOSHIDA Yukinae","@language": "en"}], "con:organization": [ { "@id":"https://ci.nii.ac.jp/org/国立情報学研究所学術基盤推進部", "@type": "foaf:Organization", "foaf:name": [{"@value": "国立情報学研究所学術基盤推進部"},{"@value": "National Institute of Informatics","@language": "en"}] } ] }, { "@id": "https://ci.nii.ac.jp/nrid/9000002411129#me", "@type": "foaf:Person", "foaf:name": [{"@value": "高橋 菜奈子"},{"@value": "TAKAHASHI Nanako","@language": "en"}], "con:organization": [ { "@id":"https://ci.nii.ac.jp/org/国立情報学研究所学術基盤推進部", "@type": "foaf:Organization", "foaf:name": [{"@value": "国立情報学研究所学術基盤推進部"},{"@value": "National Institute of Informatics","@language": "en"}] } ] } ], |
||||||
63 | @id | 著者のURI | 著者詳細ページのURIに「#me」を追加したもの | |||||||
64 | @type | 固定"foaf:Person" | ||||||||
65 | foaf:name | 配列 | 著者名に関する記述 | |||||||
66 | @value | 著者名:日本語、著者名:英語 | ||||||||
67 | @language | 著者名の言語 | 著者名:日本語の場合―@language:なし 著者名:英語の場合―@language:必須。en:英語 |
|||||||
68 | con:organization | 配列 | 著者の所属に関する記述 | 所属が複数ある場合は列挙する | ||||||
69 | @id | 著者の所属のURL | 所属名の日本語をURLにしたもの | |||||||
70 | @type | 固定"foaf:Oragnization" | ||||||||
71 | foaf:name | 配列 | 所属名に関する記述 | |||||||
72 | @value | 所属名:日本語、所属名:英語 | ||||||||
73 | @language | 所属名の言語 | キーワード:日本語の場合―@language:なし キーワード:英語の場合―@language:必須。en:英語 |
改訂履歴
2013年4月以降の改訂履歴をご確認いただけます。
2017年6月16日
- フォーマット仕様を修正しました。
- cinii:fulltext(本文の有無)を削除しました。
2015年3月13日
- フォーマット仕様を修正しました。
- @typeで雑誌記事・論文を表す情報を追加しました。
- prism:doiでDOIを表す情報を追加しました。
2014年10月15日
- 「キーワードのURI」(foaf:topic @id)の半角スペースの置換を「_」(アンダーバー)から、CiNii Books APIと同じ「+」に変更しました。
2013年10月29日
- クロスドメイン間の非同期通信に対応しました。
- 論文情報のJSON-LDのAPIを追加しました。