CiNii Books - Metadata and API - CiNii Books JSON-LD for Authors (Beta)

 

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.