DB37_T 2352.4-2013农村农业信息资源建设规范 第4部分：数据交换接口规范.pdf

ICS 65. 020.99B 04DB37山東东省地電方标准DB 37/T 2352.42013农村农业信息资源建设规范第4部分：数据交换接口规范Construction Specification for Rural and Agricultural Information Resource Part 4:Specification for Data interchanging Interface201306-13发布2013-07-10实施山东省质量技术监督局发布 DB37/T 2352.4—2013目次前言11引言III1范围2规范性引用文件3术语和定义，4符号与缩略语，5数据格式定义5. 1接口的编码方式及响应格式5.2数据交换格式6交换格式定义6. 1采用协议.6.2接口安全.6.3连接方式.6. 4技术实现6. 5接口列表6. 6建库单位开放接口 DB37/T 2352. 4—2013条记录从属于一个数据库等。GET方法用于以实体的格式获取被请求URI（Request-URI）指定的信息。如果请求URI涉及到一个数据生成过程，则此数据应被作为实体在响应中返回。6.4技术实现6.4.10penURL技术规范语法格式为：OpenURL: := BASEURL“9”QUERY-BASE-URL：基础URL，服务提供方的URL地址：QUERY：查询，包含ORIGIN-DESCRIPTION（参数名称），OBJECT-DESCRIPTION（参数值）两部分。6.4.2接口采用0penURL技术实现接口语法格式说明：http: //ur1/service?[query][?]号前面为涉农资源建设单位提供的服务地址，需要在综合平台中注册。[query]部分包括多组参数名称与参数值，其中最主要的verb参数，定义了访间服务的具体名称见接口列表中的接口名称。6.5接口列表本规范接口列表见表2。表2接口列表按口提供方接口类型按口名称接口描述dhGetDatabaseList获取数据集列表接口数据获取接口dhGetDatabaseSchena数据库结构获取接口dhGet Indexes全部索引数据获取接口建库单位dhGet IndexModificat ions增量索引数据获取接口daiGetRecord数据访问接口uiGetRecord数据显示页面获取接口数据访问接口daiquery数据集成检索接口uiQuery检索页面获取接口daiGetFile获取文件描述信息接口6.6建库单位开放接口6. 6. 1数据获取接口6. 6. 1. 1dhGetDatabaseList接口说明：数据获取接口，获得所有数据集唯一访间标识列表请求参数说明：verb: dhGetDatabaseList10 DB37/T 2352.4—2013响应格式说明：(databaseList(database!--访间该数据集唯一标识--(/database!一可以包含多个数据集--/databaseList6. 6.1. 2dhGetDatabaseSchema接口说明：数据获取接口，根据数据集唯一访间标识，获得数据库结构信忌请求参数说明：verb: dhGetDatabaseSchemauri：数据集唯一访间标识响应格式说明：schela(dataseturi数据集Uri/urititle数据集显示标题/title(entity)name实体名称/nalle(uri实体uri，往往是数据集uri.实体名/uridescription实体播透信息/descriptiontitle实体显示标题/titleidentifier主键字段/identifierfieldname属性名称/nameuri属性uri，往往是实体uri.属性名/uri)title属性显示标题/titletype属性的类型/type[target可选项。当该属性是引用或集合类型时表示关联到哪个实体上/target]/field/entityMTAname视图类型，若source为数据集，则此处为listEntities（实体列表）：若source为实体，则此处有listBeans（概览视图），showBean（细览视图）、queryEntity（查询视图），indexEntity（索引视图）四种/name)source数据集Uri或实体Uri/sourceitemsource若上层为数据集，则此处表示哪些实体：若上层为实体，则此处表示哪些属性/source/item11 DB37/T 2352.4—2013/view(/dataset/schema6. 6.1. 3dhGetIndexes接口说明：数据获取接口，索引数据获取接口（数据唯一访间标识）请求参数说明：verb: dhGet