CiNii Books図書館情報JSON-LDのフォーマット仕様について
※ベータ版のため、ご意見等をふまえフォーマット仕様に変更が生じる可能性があります。ご承知いただいたうえでご利用ください。
以下の書式のURIにアクセスすると、JSON-LD形式のデータを取得できます。取得できる情報は「CiNii Books 図書館情報のRDF」と同様です。
https://ci.nii.ac.jp/ncid/<図書館ID>.json（例：https://ci.nii.ac.jp/library/FA012943.json）
コンテントネゴシエーションに対応しています。JSON-LDのURIを指定しなくても、HTTPヘッダから判断してJSON-LDを返します。CiNii Books図書館詳細表示画面（例：https://ci.nii.ac.jp/library/FA012943）において、HTTPリクエストヘッダのAcceptフィールドにて「application/json」 あるいは「application/ld+json」の指定が他のどの指定よりも優先度が高い場合には、JSON-LDのURIへ誘導します。
レスポンスの際のhttpヘッダに「Access-Control-Allow-Origin: *」を指定していますので、クロスドメイン間での非同期通信をご利用いただけます。
フォーマット仕様
| No. | タグ名 | 型 | 必須 | 内容 | 備考 | ||||
| 第1階層 | 第2階層 | 第3階層 | 第4階層 | 第5階層 | |||||
| 1 | @context | オブジェクト | 必須 | 文書のルート要素 | "@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 | 必須 | http://purl.org/dc/elements/1.1/ | ||||||
| 3 | foaf | 必須 | http://xmlns.com/foaf/0.1/ | ||||||
| 4 | v | 必須 | http://www.w3.org/2006/vcard/ns# | ||||||
| 5 | dcterms | 必須 | http://purl.org/dc/terms/ | ||||||
| 6 | rdfs | 必須 | http://www.w3.org/2000/01/rdf-schema# | ||||||
| 7 | cinii | 必須 | http://ci.nii.ac.jp/ns/1.0/ | ||||||
| 8 | @id | 必須 | 図書館情報JSON-LDのURI | 図書館情報JSON-LDのURIを表示(ただしappidのパラメータは除く） "@id":"https://ci.nii.ac.jp/library/X123456.json", |
|||||
| 9 | @graph | 配列 | 必須 | 配列の要素数は1 | |||||
| 10 | @id | 必須 | 図書館詳細表示画面のURL | "@id":"https://ci.nii.ac.jp/library/FA123456#entity" | |||||
| 11 | @type | 配列 | 必須 | 固定 "@type":["foaf:Organization","v:VCard"], |
|||||
| 12 | foaf:isPrimaryTopicOf | オブジェクト | 必須 | 図書館情報JSON-LDのURIに関する記述 | 図書館情報JSON-LDのURIを表示(ただしappidのパラメータは除く） "foaf:isPrimaryTopicOf":{"@id":"https://ci.nii.ac.jp/library/FA123456.json"}, |
||||
| 13 | @id | 必須 | 図書館情報JSON-LDのURI | ||||||
| 14 | foaf:name | 配列 | 必須 | 図書館名に関する記述 | 例： "foaf:name":[ {"@value":"愛知淑徳大学 図書館"}, {"@value":"アイチシュクトクダイガク トショカン","@language":"ja-hrkt"} ], |
||||
| 15 | @value | 必須 | 図書館名、図書館名のよみ | ||||||
| 16 | @language | 図書館名のよみの言語 | 図書館名の場合―@language：なし 図書館名のよみの場合―@language：必須。ko：ハングル または ja-hrkt：日本語フリガナ |
||||||
| 17 | dcterms:alternative | 配列 | 図書館名の略称に関する記述 | 複数ある場合は繰り返す 例： "dcterms:alternative":[ {"@value":"愛淑大"}, {"@value":"アイシュクダイ","@language":"ja-hrkt"} ], |
|||||
| 18 | @value | 必須 | 図書館名の略称、略称のよみ | ||||||
| 19 | @language | 略称よみの言語 | 略称の場合―@language：なし 略称のよみの場合―@language：必須。ko：ハングル または ja-hrkt：日本語フリガナ |
||||||
| 20 | dcterms:hasPart | 配置コード | |||||||
| 21 | cinii:memberid | 必須 | 参加組織番号 | 図書館ID（FAID） | |||||
| 22 | cinii:organizationid | 必須 | 機関コード | KID | |||||
| 23 | cinii:prefcode | 必須 | 都道府県コード | KENCODE。コードは参加組織レコードコード一覧参照。 | |||||
| 24 | cinii:mextid | 文部省図書館コード | LIBCODE | ||||||
| 25 | cinii:catflag | 必須 | CAT参加種別 | A:参加、N:未参加 | |||||
| 26 | cinii:illflag | 必須 | ILL参加種別 | A:参加、N:未参加 | |||||
| 27 | cinii:copyservice | 必須 | 複写サービス種別 | A:複写依頼を受け付ける、C:他の窓口で受け付ける、N:複写依頼を受け付けない | |||||
| 28 | cinii:loanservice | 必須 | 貸借サービス種別 | A:貸借依頼を受け付ける、C:他の窓口で受け付ける、N:貸借依頼を受け付けない | |||||
| 29 | cinii:faxservice | 必須 | FAXサービス種別 | A:FAX送信サービス可、C:条件つきでFAX送信サービス可、N:FAX送信サービス不可 | |||||
| 30 | cinii:illstatus | 必須 | サービスステータス | A:現在サービス可、N:現在サービス不可 | |||||
| 31 | v:fn | 必須 | 図書館名 | ||||||
| 32 | v:adr | オブジェクト | 必須 | 住所に関する記述 | 例： "v:adr":{ "@type":"v:Address", "v:postal-code":"101-8430", "v:label":"東京都千代田区一ツ橋2-1-2"}, |
||||
| 33 | @type | 必須 | 固定"v:Address" | ||||||
| 34 | v:postal-code | 必須 | 郵便番号 | ||||||
| 35 | v:label | 必須 | 住所 | ||||||
| 36 | v:tel | 配列 | 電話番号に関する記述 | ||||||
| 37 | @type | 必須 | 固定"v:Tel" | ||||||
| 38 | @value | 必須 | 電話番号 | ||||||
| 39 | v:fax | 配列 | FAX番号に関する記述 | ||||||
| 40 | @type | 必須 | 固定"v:Fax" | ||||||
| 41 | @value | 必須 | FAX番号 | ||||||
| 42 | dc:description | 配列 | ポリシー | ||||||