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

 

CiNii Books JSON-LD for Libraries

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 Libraries".
https://ci.nii.ac.jp/ncid/[Library ID].json (For Example: https://ci.nii.ac.jp/library/FA012943.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 Libraries Details Page in CiNii Books (For example : https://ci.nii.ac.jp/ncid/BB08796640), 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/"
"v":"http://www.w3.org/2006/vcard/ns#",
"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   v         Required   http://www.w3.org/2006/vcard/ns#
5   dcterms         Required   http://purl.org/dc/terms/
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 Library information JSON-LD Indicates the URI of Library information JSON-LD(except parameter of appid)
"@id":"https://ci.nii.ac.jp/library/X123456.json",
9 @graph         Array Required   Element count of array is 1
10   @id         Required URL of Library informati Details Page "@id":"https://ci.nii.ac.jp/library/FA123456#entity"
11   @type       Array Required   Fixed:
"@type":["foaf:Organization","v:VCard"],
12   foaf:isPrimaryTopicOf       Object Required Description of URI for Library information JSON-LD Indicates the URI of Library information JSON-LD(except parameter of appid)
"foaf:isPrimaryTopicOf":{"@id":"https://ci.nii.ac.jp/library/FA123456.json"},
13     @id       Required URI of Library information JSON-LD  
14   foaf:name       Array Required Description of Library Name Example:
"foaf:name":[
{"@value":"愛知淑徳大学 図書館"},
{"@value":"アイチシュクトクダイガク トショカン","@language":"ja-hrkt"}
],
15     @value       Required Library Name, Transcription of Library Name  
16     @language         Language code of the transcription Library name―without "@language", Transcription of Library name―with "@language" Required. ko:Korean or ja-hrkt:Japanese transcription
17   dcterms:alternative       Array   Description of Abbreviated library Name Repeated if there are multiple items
Example:
"dcterms:alternative":[
{"@value":"愛淑大"},
{"@value":"アイシュクダイ","@language":"ja-hrkt"}
],
18     @value       Required Abbreviated library Name, Transcription of Abbreviated library Name  
19     @language         Language code of the transcription Abbreviated library name―without "@language", Transcription of Abbreviated library name―with "@language" Required. ko:Korean or ja-hrkt:Japanese transcription
20   dcterms:hasPart           Location code  
21   cinii:memberid         Required Library ID Library ID (FAID)
22   cinii:organizationid         Required Organization ID KID
23   cinii:prefcode         Required Area Code KENCODE. see the code table for library record.
24   cinii:mextid           Library code of the MEXT LIBCODE
25   cinii:catflag         Required NACSIS-CAT Membership A: Participant, N: Not Participan
26   cinii:illflag         Required ILL Membership A: Participant, N: Not Participant
27   cinii:copyservice         Required Copy Service Status A: Available, C: Require at the other library, N: Not available
28   cinii:loanservice         Required Loan Service Status A: Available, C: Require at the other library, N: Not available
29   cinii:faxservice         Required Fax Service Status A: Available, C: Require at the other library, N: Not available
30   cinii:illstatus         Required ILL Service Status A: Currently Available, N: Currently Not available
31   v:fn         Required Library Name  
32   v:adr       Object Required Description of Address Example:
"v:adr":{
"@type":"v:Address",
"v:postal-code":"101-8430",
"v:label":"東京都千代田区一ツ橋2-1-2"},
33     @type       Required   Fixed: "v:Address"
34     v:postal-code       Required Postal Code  
35     v:label       Required Address  
36   v:tel       Array   Description of Phone Number  
37     @type       Required   Fixed: "v:Tel"
38     @value       Required Phone Number  
39   v:fax       Array   Description of FAX Number  
40     @type       Required   Fixed: "v:Fax"
41     @value       Required Fax number  
42   dc:description       Array   Policy  
 

Revision History

You can check revision history of CiNii Articles JSON-LD API for Articles later April, 2013.

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.