CiNii Articles - メタデータ・API - CiNii Articles 論文情報のJSON-LD(ベータ版)

 

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