家谱开放数据接口说明

《家谱开放数据接口说明》由会员上传分享，免费在线阅读，更多相关内容在应用文档-天天文库。

1、家谱开放数据接口说明一、综述家谱开放数据接口目前提供以下两种形式的数据接口。1.通过访问资源URI获取数据：根据标准API接口，通过访问单个资源的URI，获得该资源的所有RDF三元组(属性和值)。2.通过查询接口获取特定类型的数据：通过特定API接口，获取“姓氏”、“先祖名人”、“地点”、“机构”、“朝代”、“书目”的数据。（每次最多取得20条数据）3.通过SparqlEndpoint获取数据注：使用家谱开放数据接口时需要提供APIKey进行验证。开发人员请在上海图书馆数据开放平台进行用户注册，并获取独立的APIKey

2、。注册网址：http://data.library.sh.cn/jp/userlogin/tologin二、接口调用方式说明1.通过访问资源URI获取数据功能：输入资源URI，获取资源的RDF数据。如返回结果数据中存在其他资源的URI时，可通过该接口获取其他资源的RDF数据。API接口：http://data.library.sh.cn/jp/data/json?uri=[参数1]&key=[参数2]输入：[参数1]：资源URI[参数2]：用户的APIKey输出：包含资源及其属性和值的JSON-LD数据资源类型与URI

3、设计规范：对象命名空间家谱文献题名http://data.library.sh.cn/jp/authority/title/实例（bf:Instance）http://data.library.sh.cn/jp/resource/instance/朝代http://data.library.sh.cn/authority/temporal/版本类型取值词表http://data.library.sh.cn/vocab/edition/作品（bf:Work）http://data.library.sh.cn/jp/res

4、ource/work/谱籍地http://data.library.sh.cn/entity/place/机构http://data.library.sh.cn/entity/organization/单件（bf:Item）http://data.library.sh.cn/jp/resource/item/人物http://data.library.sh.cn/jp/entity/person/堂号http://data.library.sh.cn/jp/authority/titleofancestraltempl

5、e/姓氏http://data.library.sh.cn/authority/familyname/例如：输入：http://data.library.sh.cn/jp/data/json?uri=http://data.library.sh.cn/jp/authority/title/huk223doncajistd&key=02cdb77b436d4dc383f1b64exxxxxxxxx输出：{"@id":"http://data.library.sh.cn/jp/authority/title/huk223d

6、oncajistd","@type":["http://bibframe.org/vocab/WorkTitle","http://bibframe.org/vocab/Title"],"label":[{"@language":"cht","@value":"豐原陳氏家譜"},{"@language":"chs","@value":"丰原陈氏家谱"}],"@context":{"label":"http://bibframe.org/vocab/label"}}1.通过查询接口获取特定类型的数据（1）姓氏功能：输入姓

7、氏获取对应的资源数据。数据匹配方式为完全匹配。API接口：http://data.library.sh.cn/jp/familyname/[参数1]?key=[参数2]输入：[参数1]：姓氏[参数2]：用户的APIKey输出：包含姓氏属性和值的JSON-LD数据例如：输入：http://data.library.sh.cn/jp/familyname/陈?key=02cdb77b436d4dc383f1b64exxxxxxxxx输出：{"@id":"http://data.library.sh.cn/authority

8、/familyname/9i5ukkrs9ebh6qmz","@type":"http://www.library.sh.cn/ontology/FamilyName","label":[{"@language":"chs","@value":"陈"},{"@language":"en","@value":"chen"},{"@l