家谱开放数据接口培训.pptx

家谱开放数据 接口说明 培训人：陈尚松 上海图书馆数据接口形式2数据接口形式3数据接口形式11.通过访问资源URI获取数据：根据标准API接口，通过访问单个资源的URI，获得该资源的所有RDF三元组(属性和值)2. 通过查询接口获取特定类型的数据：通过特定API接口，获取“姓氏”、“先祖名人”、“地点”、“机构”、“朝代”、“书目”的数据。（每次最多取得20条数据）3. 通过Sparql Endpoint获取数据。一，家谱开放数据接口目前提供以下三种形式的数据接口家谱开放数据接口目前提供以下两种形式的数据接口上海图书馆特别说明 使用家谱开放数据接口时需要提供APIKey进行验证。开发人员请在上海图书馆数据开放平台进行用户注册，并获取独立的APIKey。注册网址：/jp/userlogin/tologin上海图书馆二、接口调用方式说明1.通过访问资源URI获取数据功能：输入资源URI，获取资源的RDF数据。如返回结果数据中存在其他资源的URI时，可通过该接口获取其他资源的RDF数据。API接口： /jp/data/json?uri=[参数1]key=[参数2]输入：[参数1]：资源URI[参数2]：用户的APIKey输出：包含资源及其属性和值的JSON-LD数据上海图书馆资源类型与URI设计规范：对象命名空间家谱文献题名/jp/authority/title/实例（bf:Instance）/jp/resource/instance/朝代/authority/temporal/版本类型取值词表/vocab/edition/作品（bf:Work）/jp/resource/work/谱籍地/entity/place/机构/entity/organization/单件（bf:Item）/jp/resource/item/人物/jp/entity/person/堂号/jp/authority/titleofancestraltemple/姓氏/authority/familyname/上海图书馆例如：输入：/jp/data/json?uri=/jp/authority/title/huk223doncajistdkey=02cdb77b436d4dc383f1b64exxxxxxxxx输出：见演示.上海图书馆2.通过查询接口获取特定类型的数据（1）姓氏功能：输入姓氏获取对应的资源数据。数据匹配方式为完全匹配。API接口： /jp/familyname/[参数1]?key=[参数2]输入：[参数1]：姓氏[参数2]：用户的APIKey输出：包含姓氏属性和值的JSON-LD数据例如：输入：/jp/familyname/陈?key=02cdb77b436d4dc383f1b64exxxxxxxxx输出：见演示。上海图书馆返回属性说明：属性类型说明labelliterialvalue：姓名language：语言“chs”：中文简体“cht”：中文繁体“en”：英文descriptionliterial姓氏描述上海图书馆2.通过查询接口获取特定类型的数据（2）先祖名人功能：输入先祖名人的姓名，获取对应的资源数据。数据匹配方式为模糊匹配。API接口：/jp/person/[参数1]?key=[参数2]输入：[参数1]：先祖名人姓名[参数2]：用户的APIKey输出：包含先祖名人属性和值的JSON-LD数据（数组格式）例如：输入：/jp/person/丁丙?key=02cdb77b436d4dc383f1b64exxxxxxxxx输出：见演示.上海图书馆返回属性说明：属性类型说明labelliterialvalue：姓名language：语言“chs”：中文简体“cht”：中文繁体“en”：英文relatedWorkURI相关家谱文献的URIroleOfFamilyURI角色URI（人在家族中的角色，如始祖、始迁祖等先祖类型。）familyNameURI姓氏URIgender literial性别family URI家族URIchildOf URI父亲URIspouseOf URI配偶URIgenealogyName literial谱名（人在家谱上记载的谱名。）courtesyName literial字pseudonym literial号orderOfSeniority literial排行generationCharacter literial字辈posthumousTitle literial谥号birthday literial生于deathday literial卒于descriptionliterial人物描述temporalValueliterial朝代描述temporalURI朝代URI上海图书馆2.通过查询接口获取特定类型的数