Contents
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 data. | |||||
| 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 | ||||||