Contents
CiNii Books JSON-LD for Authors
Note: This is a Beta version therefore Format Specification may be subject to change hereafter depending on user feedbacks. Please be advised before using.
When you access to the following URI, you can obtain the data with JSON-LD format. What information you can obtain is as the same as "CiNii Books RDF for Authors".
https://ci.nii.ac.jp/ncid/<Author ID>.json(For example: https://ci.nii.ac.jp/author/DA15839119.json)
Content Negotiation is also acceptable. Even if JSON-LD URI is not be specified, JSON-LD will respond by recognition from HTTP header. At the Author Details Page in CiNii Books (For example:https://ci.nii.ac.jp/author/DA15839119), specification of "application/json" or "application/ld+json" in accept field of HTTP request header has much priority than any other specifications, it will induce automatically to URI of JSON-LD.
"Access-Control-Allow-Origin*" is required on http header for response, and it is available to use asynchronous communication between cross domains.
Format Specification
No. | Tag Name | Type | Required | Contents | Remarks | ||||
First level | Second level | Third level | Fourth level | Fifth level | |||||
1 | @context | Object | Required | Document route element | "@context":{ "dc":"http://purl.org/dc/elements/1.1/", "foaf":"http://xmlns.com/foaf/0.1/", "dcterms":"http://purl.org/dc/terms/" "owl":"http://www.w3.org/2002/07/owl#", "rdfs":"http://www.w3.org/2000/01/rdf-schema#", "cinii":"http://ci.nii.ac.jp/ns/1.0/", }, |
||||
2 | dc | Required | http://purl.org/dc/elements/1.1/ | ||||||
3 | foaf | Required | http://xmlns.com/foaf/0.1/ | ||||||
4 | dcterms | Required | http://purl.org/dc/terms/ | ||||||
5 | owl | Required | http://www.w3.org/2002/07/owl# | ||||||
6 | rdfs | Required | http://www.w3.org/2000/01/rdf-schema# | ||||||
7 | cinii | Required | http://ci.nii.ac.jp/ns/1.0/ | ||||||
8 | @id | Required | URI of Author JSON-LD | Indicates the URI of Author JSON-LD(except parameter of appid) "@id":"https://ci.nii.ac.jp/author/XX12345678.json", |
|||||
9 | @graph | Array | Required | Element count of array is 1 | |||||
10 | @id | Required | URI of Author | "#entity" is added to URI in Author Details Page "@id":"https://ci.nii.ac.jp/author/XX12345678#entity", |
|||||
11 | @type | Required | c→"foaf:Organization" p→"foaf:Person" m→"foaf:Group" none→"foaf:Agent" |
||||||
12 | foaf:isPrimaryTopicOf | Object | Required | Description of URI for Author JSON-LD | Indicates the URI of Author JSON-LD( except parameter of appid) "foaf:isPrimaryTopicOf":{"@id":"https://ci.nii.ac.jp/author/XX12345678.json"}, |
||||
13 | @id | Required | URI of Author JSON-LD | ||||||
14 | foaf:name | Array | Required | Description of Author name | Example: "foaf:name":[ {"@value":"大向, 一輝"}, {"@value":"オオムカイ, イッキ","@language":"ja-hrkt"} ], |
||||
15 | @value | Required | Author Name, Transcription of Author Name | ||||||
16 | @language | Language code of the transcription | Author Name―without "@language", Transcription of Author Name―with "@language" Required. ko:Korean or ja-hrkt:Japanese transcription | ||||||
17 | foaf:givenName | First name | |||||||
18 | foaf:middleName | Middle Name | |||||||
19 | foaf:familyName | Last name | |||||||
20 | cinii:authorid | Required | Author ID | 著者名典拠ID | |||||
21 | dcterms:alternative | Array | Other name | Repeated if there are multiple items. | |||||
22 | owl:sameAs | Array | Description of the other name | Repeated if there are multiple items. Example: "owl:sameAs":[ {"@id":"https://ci.nii.ac.jp/author/DA00518213#entity", "dc:title":"栗本, 薫"} ] |
|||||
23 | @id | URI of other author name | If Author ID is given to a person who has an alternative name (For example, published in other names), URI of Author indicates as an alternative author name. "#entity" is added to URI in Author Details Page. | ||||||
24 | dc:title | Required | Other name | ||||||
25 | rdfs:seeAlso | Array | Required | Description of External links | |||||
26 | @id | Required | URL of External links | ||||||
27 | dc:title | Required | Name of other website |
Revision History
You can check revision history of CiNii Articles JSON-LD API for Articles later April, 2013.
April 19, 2017
- Change the Format Specification.
- Added information about author attribution in No.11.
March 13, 2015
- Change the Format Specification.
- Added information about external links in No.24-26.
October 11, 2013
- It has been available to use asynchronous communication between cross domains.
- CiNii Articles JSON-LD of API for Articles (Beta) has been available.