版权说明:本文档由用户提供并上传,收益归属内容提供方,若内容存在侵权,请进行举报或认领
文档简介
ICS35.240
CCSL77
3502/T
福建省厦门市地方标准
DB3502/T056.3—2020
政务信息共享协同平台
第3部分:接入要求
Thesharingandcollaborativeplatformofgovernmentinformation—
Part3:Interfacerequirement
2020-12-31发布2021-01-01实施
厦门市市场监督管理局发布
DB3502/T056.3—2020
目次
前言................................................................................III
引言.................................................................................IV
1范围...............................................................................1
2规范性引用文件.....................................................................1
3术语和定义.........................................................................1
4缩略语.............................................................................2
5网络链路架构.......................................................................2
6生产方接入.........................................................................3
接入服务接口资源...............................................................3
接入数据文件资源...............................................................4
接入数据库表资源...............................................................4
接入数据流资源.................................................................5
7消费方接入.........................................................................6
使用服务接口资源...............................................................6
使用数据文件资源...............................................................7
使用数据库表资源...............................................................7
使用数据流资源.................................................................8
8区级平台接入.......................................................................8
区级平台接入概述...............................................................8
区级平台接入申请...............................................................8
调用平台服务接口流程...........................................................9
公共参数说明..................................................................10
平台对接接口..................................................................10
附录A(资料性)协同平台错误码表....................................................21
附录B(资料性)共享服务资源调用示例................................................22
B.1调用步骤说明..................................................................22
B.2Java语言版本调用示例..........................................................22
附录C(资料性)区级平台接入规范报文示例............................................28
C.1请求报文示例..................................................................28
C.2退出登录接口..................................................................28
C.3表码获取接口..................................................................29
C.4“我的服务”接口..............................................................30
C.5新增、修改服务接口............................................................32
C.6获取服务详细信息接口..........................................................33
C.7服务提交审核接口..............................................................35
C.8获取可申请的外部服务列表接口..................................................36
C.9申请外部服务接口..............................................................38
I
DB3502/T056.3—2020
参考文献..............................................................................39
II
DB3502/T056.3—2020
前言
本文件按照GB/T1.1—2020《标准化工作导则第1部分:标准化文件的结构和起草规则》的规定
起草。
本文件为DB3502/T056《政务信息共享协同平台技术规范》的第3部分。DB3502/T056已发布了以
下部分:
——第1部分:总体设计;
——第2部分:资源管理;
——第3部分:接入要求;
——第4部分:二次开发。
本文件是在DB3502/Z033.3—2016《政务信息共享协同平台技术规范第3部分:平台接入规范》的
基础上,根据技术和需求变化,重新立项并制定的。与DB3502/Z033.3—2016相比,除结构性调整和编
辑性改动外,主要技术变化如下:
a)根据平台资源管理要求,同步调整生产方接入流程及操作,或重新释义(见第6章,DB3502/Z
033.3—2016的第7章);
b)根据平台资源管理要求,同步调整消费方接入流程及操作,或重新释义(见第7章,DB3502/Z
033.3—2016的第6章、第8章);
c)根据平台资源管理要求,同步调整区级平台接入流程及操作,或重新释义(见第8章,DB3502/Z
033.3—2016的第9章);
d)增加接入日志记录要求,建立调用方与平台的对账机制(见.5);
e)完善带TLS的服务资源接入要求说明(见,DB3502/Z033.3—2016的7.2.3);
f)增加服务接入URL地址释义(见.1);
g)增加平台错误码表(见附录A);
h)按照当前接入要求提供示例代码(见附录B、附录C,DB3502/Z033.3—2016的附录B、附录
C)。
请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。
本文件由厦门市工业和信息化局提出。
本文件由厦门市工业和信息化局归口。
本文件起草单位:厦门畅享信息技术有限公司、厦门市标准化研究院、厦门市信息中心。
本文件主要起草人:郭劲军、郭望、傅楚隆、揭英杰、吴宸勖、陈尚峰、卢淼先、闫焕友、李童、
蔡跃华、张金梅、刘姗姗、吕志仁、赖炜炜、巫晓强、杨远军、朱永上、彭明剑。
III
DB3502/T056.3—2020
引言
DB3502/T056《政务信息共享协同平台》旨在确立政务信息共享协同平台总体设计、资源管理、接
入要求、二次开发的技术标准,拟由四个部分构成。
——第1部分:总体设计。目的在于确立平台关键技术路线和软件系统的组织形式,确保平台总
体架构满足国家对政务信息交换与共享的要求,明确平台内主要功能模块和模块间的逻辑关
系,避免“过度建设”并确保“必要建设”。
——第2部分:资源管理。目的在于规范平台所支持的多种资源类型、协议标准、提供方式,为
平台对外服务的兼容性提供保障;明确平台不同类型资源的属性,统一属性分类,为平台对
外服务的通用性提供保障;针对资源生产、资源注册、资源测试、资源申请、资源调用、资
源目录、资源检索、资源版本、资源安全等操作提出全生命周期管理要求,为平台对外服务
的可用性提供保障。
——第3部分:接入要求。目的在于将平台对外接口标准化,明确接口在安全性、完备性、一致
性、易用性、稳定性方面要求,进一步提升平台对外提供服务的能力和质量,并从网络接
入、平台资源生产方、平台资源消费方、区级平台接入等方面,明确接入的实现方式,为保
障平台建设质量及拓展平台应用范围提供技术支撑。
——第4部分:二次开发。目的在于规范平台提供二次开发的工作方式、对扩展模块管理方式,
为后续平台业务流程及插件的完善提供统一标准,既避免了平台直接耦合上层各类业务,又
允许不同部门结合特定业务需要,在授权范围内扩展平台功能。
IV
DB3502/T056.3—2020
政务信息共享协同平台
第3部分:接入要求
1范围
本文件规定了生产方、消费方、区级平台接入政务信息共享协同平台的技术要求。
本文件适用于政务信息共享协同平台中的生产方接入、消费方接入、区级平台接入,各部门应用系
统接入时参照使用。
2规范性引用文件
下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中,注日期的引用文件,
仅该日期对应的版本适用于本文件;不注日期的引用文件,其最新版本(包括所有的修改单)适用于本
文件。
DB3502/T056.1—2020政务信息共享协同平台第1部分:总体设计
DB3502/T056.2—2020政务信息共享协同平台第2部分:资源管理
3术语和定义
DB3502/T056.1—2020、DB3502/T056.2—2020界定的以及下列术语和定义适用于本文件。
请求方IDrequesteridentity
协同平台为每个服务消费方分配的唯一标识。
服务方IDservicesidentity
协同平台为每个服务生产方分配的唯一标识。
融合服务compositeservice
基于服务流程引擎,融合多个原子服务,实现将多个细颗粒度服务,融合为一个粗颗粒度服务。
请求接入requesteraccess
按照协同平台标准,服务消费方接入到本平台,并且调用其他单位服务的过程。
服务接入servicesaccess
按照协同平台标准,服务生产方接入到本平台,对外服务的过程。
消息(用于编程语言)message(inprogramminglanguages)
对象进行其各一次运算之一的一次请求。
[来源:GB/T5217.15—2008,15.09.06]
1
DB3502/T056.3—2020
请求报文requestmessage
服务消费方向协同平台发出的报文。
响应报文responsemessage
协同平台返回给服务消费方的结果报文。
4缩略语
下列缩略语适用于本文件。
API:应用程序编程接口(ApplicationProgrammingInterface)
APP:应用程序(APPlication)
CPU:中央处理器(CentralProcessingUnit)
GB:计算机存储单位,吉字节(GigaByte)
HTTP:超文本传输协议(HyperTextTransferProtocol)
ID:唯一编码(IdentityDocument)
JSON:基于“JavaScript”语言形式的数据对象表达方式(JavaScriptObjectNotation)
RTSP:实时流传输协议(RealTimeStreamingProtocol)
REST:表述性状态转移(REpresentationalStateTransfer)
SDK:软件开发工具包(SoftwareDevelopmentKit)
SFTP:SSH文件传输协议(SSHFileTransferProtocol)
SOAP:简单对象访问协议(SimpleObjectAccessProtocol)
SSL:安全套接层(SecureSocketsLayer)
TCP:传输控制协议(TransmissionControlProtocol)
TLS:传输层安全协议(TransportLayerSecurity)
UDP:用户数据报协议(UserDatagramProtocol)
UTF-8:8位的针对Unicode的可变长度字符编码(8-bitUnicodeTransformationFormat)
URL:统一资源定位系统(UniformResourceLocator)
WSDL:Web服务器描述语言(WebServiceDescriptionLanguage)
XML:扩展性标识语言(eXtensibleMarkupLanguage)
XSD:XML结构定义(XMLSchemaDefinition)
5网络链路架构
图1网络链路架构
2
DB3502/T056.3—2020
网络链路架构见图1。分控中心应采用独立的服务器作为接入前置机,接通与总控中心服务器的
网络。接入前置机和总控中心服务器、分控中心内部业务系统之间,应根据分控中心的安全需求,架设
一道或多道防火墙等网络安全设备。
基本配置要求如下:
a)网络要求:局域网接入速度应大于100Mb/s;
b)前置机配置要求:CPU主频不低于1.5GHz,核心数不少于4个,内存不低于4G,采用Linux
或自主可控操作系统;
c)部署接入前置机应由部门端和总控中心双方共同管理。前置机上主要部署分控中心所需的软
件环境,不宜部署其它应用。
6生产方接入
接入服务接口资源
6.1.1服务接入流程
服务接入涉及到两类用户,分控管理员和总控管理员。
分控管理员登录分控中心,填写服务接口的共享资源信息,包括资源的基础信息、共享权责和技术
参数。所填写信息经测试通过后,提交总控中心审批。总控管理员审批通过后,其他单位可查看资源列
表,并按需发起申请。
服务接入过程中所需注册的信息包括资源类型、主题信息、资源名称、资源ID、所属应用、失效日
期、共享类型、共享范围、服务地址、服务方法名、入参配置、出参配置、资源描述、资源文档。字段
含义参照DB3502/T056.2—2020中5.1的说明。
6.1.2技术要求
WebService接入
.1接入到平台的WebService服务应满足表1的版本要求。
表1WebService版本要求
技术点最低版本要求
TransferHTTP1.1
MessageFormatandProtocolsSOAP1.1or1.2
IdentityorLocationWS-Addressing1.0
ServiceDefinitionXMLSchemaWSDL1.1
.2接入本平台的服务方默认只支持基本数据类型,以消除由于使用不同语言、不同框架实现
WebService框架产生的差异。针对复杂数据结构,宜采用XML结构(string类型)描述,以实现一步
式接入。
REST服务接入
服务的报文格式及交换形式满足HTTP1.0或HTTP1.1传输协议,采用GET或POST方法提起请求,采用
JSON格式、XML或自定义纯文本作为请求或回应报文的载体格式。
带TLS的服务资源接入
3
DB3502/T056.3—2020
协同平台支持采用TLS1.1及以上的版本进行传输加密的服务资源注册,支持以下方式。对于b)和c)
方式,资源在注册过程中应提供相应的身份认证证书。
a)不做身份认证仅加密报文。
b)加密报文且实现请求方通过证书验证服务方,服务方不验证请求方。
c)加密报文且请求与服务方相互验证对方身份三种安全交换方式。
接入数据文件资源
6.2.1数据文件资源接入流程
数据文件资源接入涉及到两类用户,分控管理员和总控管理员。
分控管理员登录分控中心,填写数据文件的共享资源信息,包括资源的基础信息、共享权责和技术
参数。所填写信息经测试通过后,提交总控中心审批。总控管理员审批通过后,其他单位可查看资源列
表,并按需发起申请。
服务接入过程中所需注册的信息包括主题信息、资源名称、资源ID、所属应用、失效日期、共享类
型、共享范围、上传方式、资源描述、资源文档。字段含义参照DB3502/T056.2—2020中5.1的说明。
6.2.2技术要求
数据文件资源应符合以下要求,以提供稳定的数据资源共享服务:
a)文件大小单文件应不超过2GB,如超过此限制,应使用压缩分片工具对大文件进行分割后再共
享;
b)文件目录的目录层级应不超过3层;
c)SFTP协议传输时应将目录名、文件名指定为UTF-8编码格式。
接入数据库表资源
6.3.1数据库表资源接入流程
数据库表资源接入涉及到两类用户,分控管理员和总控管理员。
分控管理员登录分控中心,填写数据库表的共享资源信息,包括资源的基础信息、共享权责和技术
参数。所填写信息经测试通过后,提交总控中心审批。总控管理员审批通过后,其他单位可查看资源列
表,并按需发起申请。
服务接入过程中所需注册的信息包括资源类型、主题信息、资源名称、资源ID、所属应用、失效日
期、共享类型、共享范围、数据加载方式、数据源、数据库类型、数据连接、数据库表、数据库表结构、
资源描述、资源文档。字段含义参照DB3502/T056.2—2020中5.1的说明。
6.3.2技术要求
数据库类型
协同平台支持Oracle、Mysql、SqlServer等关系型数据库的数据库类型的库表资源共享。
数据库表结构
数据库表类型共享资源应符合以下要求:
a)数据库表名应不超过30个字符;
b)数据库表都应有唯一的主键;
c)数据库表都应有描述数据更新的时间戳字段;
4
DB3502/T056.3—2020
d)数据库表的字段类型应在可共享字段类型范围内,暂不支持CLOB、BLOB及其他类型字段,具
体见表2。
表2数据库表支持字段类型说明
ORACLE字段MySQL字段是否支持
TINYINT支持
SMALLINT支持
MEDIUMINT支持
INT或INTEGER支持
NUMBERBIGINT支持
FLOAT支持
DOUBLE支持
DECIMAL支持
YEAR支持
DATEDATE支持
TIME支持
TIMESTAMPDATETIME支持
TIMESTAMP支持
CHARCHAR支持
VARCHAR2VARCHAR支持
TINYTEXT暂不支持
TEXT暂不支持
CLOB
MEDIUMTEXT暂不支持
LONGTEXT暂不支持
TINYBLOB暂不支持
BLOB暂不支持
BLOB
MEDIUMBLOB暂不支持
LONGBLOB暂不支持
其他其他暂不支持
接入数据流资源
6.4.1数据流资源接入流程
数据流资源接入涉及到两类用户,分控管理员和总控管理员。
分控管理员登录分控中心,填写类型数据流的共享资源信息,包括资源的基础信息、共享权责和技
术参数。所填写信息经测试通过后,提交总控中心审批。总控管理员审批通过后,其他单位可查看资源
列表,并按需发起申请。
服务接入过程中所需注册的信息包括资源类型、主题信息、资源名称、资源ID、所属应用、失效日
期、共享类型、共享范围、协议类型、服务IP地址、服务端口、资源描述、资源文档。字段含义参照
DB3502/T056.2—2020中5.1的说明。
6.4.2技术要求
协同平台支持基于TCP、UDP类型的数据流资源共享,如MQ、Redis、HTTP、RTSP等协议传输的资源。
5
DB3502/T056.3—2020
7消费方接入
使用服务接口资源
7.1.1使用服务接口接入流程
消费方使用服务接口接入流程包括两步:第一步是分控管理员填写申请使用服务的信息,总
控管理员审批通过后,将获得调用该服务的权限。第二步是单位的应用系统构建请求报文,调用协同平
台的请求接口,获取结果数据。
申请服务所需填写的主要信息包括:
a)资源ID:协同平台唯一表征某一共享资源的英文标签,应符合DB3502/T056.2—2020第5章
的要求;
b)申请ID:用于在协同平台表征本次申请行为的唯一英文标记;
c)联系人:指定请求申请目标服务的联系人信息;
d)联系人电话:指定请求申请目标服务的联系人电话;
e)授权业务:指定请求申请目标服务所用的授权业务;
f)授权应用系统:指定请求申请目标服务所用的授权应用系统;
g)使用频率:指定请求申请目标服务所用的最高频率;
h)使用并发量:指定请求申请目标服务所用的最高并发量;
i)其他技术请求:指定请求申请目标服务所用的其他技术请求。
7.1.2接入方式
请求接入
协同平台支持基于HTTP+REST风格URL调用。如调用不成功,应返回错误码给消费方。错误码及说明
见附录A。
消费方基于REST风格的接入
.1协同平台服务资源宜表示为REST风格的URL地址。格式及说明见图2。
.2协同平台服务资源访问前需通过URL获取凭证令牌才可访问资源。格式及说明见图3。
.3协同平台服务资源短码通过在协同平台申请的资源详情下载使用手册来查阅。授权短码代
表应用与共享服务资源的对应关系,不同应用对同个可访问授权资源的授权短码是不同的。
.4通过请求协同平台服务资源来完成的政务业务,URL格式详见图2。
.5协同平台记录被调用日志时,需记录办件编码信息;调用方记录调用日志时,需记录办件
编码信息。
图2REST风格服务资源URL地址说明
6
DB3502/T056.3—2020
图3凭证令牌获取URL地址说明
消费方基于SDK的接入
协同平台升级版本后,依旧兼容旧版的SDK调用方式,在服务请求方不改变原有调用方式的情况下,
原已申请的服务资源应可继续使用。新申请的服务,宜使用REST风格的接入标准。共享服务资源调用示
例见附录B。
使用数据文件资源
7.2.1使用数据文件资源接入流程
消费方使用数据文件资源接入流程包括两步:
a)第一步:分控管理员填写信息并申请使用数据文件资源,经总控管理员审批通过后,获得调用
该数据文件资源的权限;
b)第二步:消费方或消费方的应用系统通过SFTP协议或指定的文件接收目录,获取相应的数据
文件资源。
申请数据文件资源所需填写的主要信息包括:
a)资源ID:协同平台唯一表征某一共享资源的英文标签,应符合DB3502/T056.2—2020第5章
的要求;
b)申请ID:用于在协同平台表征本次申请行为的唯一英文标记;
c)联系人:指定请求申请目标数据文件资源的联系人信息;
d)联系人电话:指定请求申请目标数据文件资源的联系人电话;
e)授权业务:指定请求申请目标数据文件资源所用的授权业务;
f)授权应用系统:指定请求申请目标数据文件资源所用的授权应用系统;
g)接收方式:指定数据文件资源的接收方式,包含SFTP和本地目录两种方式。SFTP模式需提交
SFTP地址、用户名和密码,本地目录接收指定服务器的接收目录。
7.2.2接入方式
按照申请信息中的相关要求,初始化对应的SFTP用户及目录。
使用数据库表资源
7.3.1使用数据库表资源流程
消费方使用数据库表资源流程包括三步:
a)第一步:分控管理员填写信息并申请使用数据库表,经总控管理员审批通过后,获得使用该数
据库表的权限;
b)第二步:总控管理员配置数据库交换方案,将数据同步到前置库或推送到业务库;
c)第三步:消费方按要求从前置库或本地业务库获取结果数据。
申请服务所需填写的主要信息包括:
7
DB3502/T056.3—2020
a)资源ID:协同平台唯一表征某一共享资源的英文标签,应符合DB3502/T056.2—2020第5章
的要求;
b)申请ID:用于在协同平台表征本次申请行为的唯一英文标记;
c)联系人:指定请求申请目标数据库表资源的联系人信息;
d)联系人电话:指定请求申请目标数据库表资源的联系人电话;
e)授权业务:指定请求申请目标数据库表资源所用的授权业务;
f)授权应用系统:指定请求申请目标数据库表资源所用的授权应用系统;
g)同步字段:指定请求申请数据库表资源要同步的字段集;
h)接收方式:指定请求申请数据库表资源的接收方式,包含前置库读取或推送到本地业务库;
i)接收数据源:指定请求申请数据库表资源的接收数据源相关属性,包含:用户名、密码、数据
库类型、字符集、数据库参数、数据库表。
7.3.2接入方式
按照申请信息中的相关要求,初始化对应的数据库用户及库表信息。
使用数据流资源
7.4.1使用数据流资源流程
消费方使用数据流资源流程包括两步:
a)第一步:分控管理员填写信息并申请使用服务,经总控管理员审批通过后,获得调用该服务的
权限;
b)第二步:消费方的应用系统构建请求报文,调用协同平台的请求接口,获取结果数据。
申请服务所需填写的主要信息包括:
a)资源ID:协同平台唯一表征某一共享资源的英文标签,应符合DB3502/T056.2—2020第5章
的要求;
b)申请ID:用于在协同平台表征本次申请行为的唯一英文标记;
c)联系人:指定请求申请目标数据流资源的联系人信息;
d)联系人电话:指定请求申请目标数据流资源的联系人电话;
e)授权业务:指定请求申请目标数据流资源所用的授权业务;
f)授权应用系统:指定请求申请目标数据流资源所用的授权应用系统;
g)授权IP:指定请求申请目标数据流资源授权可访问的IP地址。
7.4.2接入方式
按照目标数据流资源指定的数据访问协议,访问协同平台开放的数据流资源IP端口。
8区级平台接入
区级平台接入概述
包括区级协同平台在内的第三方应用(以下以区级平台示例),应通过接入本平台以获得各类已开
放的资源。协同平台提供基于WebService形式的开发接口。接入报文示例见附录C。
区级平台接入申请
8.2.1区级平台接入之前,应在市政务信息共享协同平台管理系统发起接入申请。其中需要选择所需
8
DB3502/T056.3—2020
要协同平台给予提供的权限接口,可选范围包括:
a)我的服务接口:获得查看区级平台向市级平台已申请的服务列表,或区级平台已向市级平台发
布的服务列表;
b)获取可申请服务接口:获得查看市级平台所有可向区级平台开放的服务目录列表;
c)发布服务接口:调用该接口,可向市级平台开放区级平台上的服务资源;
d)申请服务接口:调用该接口,可向市级平台申请区级平台所需的服务资源;
e)修改服务接口:修改已经发布到市级平台的服务接口的部分配置;
f)调用服务接口:调用已通过“申请服务接口”,并完成并通过申请的市级平台服务。
8.2.2审核通过后,指定应用即可上线调用指定的市级平台接口。
8.2.3应用审核通过后,应获得由市级平台自动分配给本应用的且不可更改的AppID和SecretKey
等属性:
a)AppID:由系统生成,作为应用的唯一标识;
b)SecretKey:由系统生成,用来验证应用合法性的加密串。
8.2.4具体操作流程如下:
a)在管理页面填写基本信息,应包括:应用名称、简介,并选择待申请使用的接口范围;
b)信息填写完成并提交审核后,进入审核阶段;
c)平台管理员审核通过,可获得相应权限。
调用平台服务接口流程
8.3.1拥有平台用户帐号和应用AppID和SecretKey后,应用应凭借二者调用资源,调用时序见图
4。
8.3.2调用平台中不需要权限的API时,宜直接调用,无须携带AccessToken,但仍应对参数进行签
名。对于平台中需要权限的API,第三方应用应先进行一个登陆验证,获取访问凭证AccessToken,在
调用时将AccessToken作为参数。(平台对接接口应符合8.5的要求)。传入及返回字符集均采用UTF-
8格式。
图4平台服务接口调用时序
9
DB3502/T056.3—2020
公共参数说明
8.4.1平台服务调用接口公共入参表见表3。各项入参应进行URL编码。
表3平台服务调用接口公共入参表
参数名称是否必须类型描述
appid是string应用的唯一ID。通过appid查找APP基本信息。
请求串的签名,具体签名算法见上一节第三方应用签名参数sig
sig是string
的说明。
返回值的格式。请指定为JSON或者XML,缺省值为JSON,忽略大
format否string
小写
登录验证后获得的token(注:调用需权限的资源时必须,没有
access_token是string
特别说明不需要的均需携带此参数)
8.4.2平台服务调用公共出参表见表4。其余业务返回参数封装在data字段中,由各个API自行定
义。
表4平台服务调用公共出参表
参数名称描述
ret返回码。
msg如果错误,返回错误信息。
data存放业务返回参数
平台对接接口
8.5.1签名生成
在使用HTTP协议请求接口时,为了确保应用与API服务器之间的安全通信,防止SecretKey盗用,
数据篡改等恶意攻击,平台API服务器使用签名机制(即sig参数)以认证应用。签名由请求参数和应用
的私钥SecretKey经过MD5加密后生成的字符串构成。应用在调用平台API之前,应计算出签名,并追加
到请求参数中。
8.5.2签名算法
待签名的源串包括3部分内容并用“&”字符拼接:HTTP请求方式&urlencode(uri)&
urlencode(a=x&b=y&...)。
在源串的末尾追加上应用的SecretKey值得到整个字符串,再对其进行MD5计算,得到签名
的值。
下面以/user/get_info为例描述签名算法。
a)第一步:原始请求信息:
1)HTTP请求方式:GET;
2)请求的URI路径(不含HOST):/user/get_info;
3)请求参数:appid=123456&format=json&name=jack&access_token=e123456。
b)第二步:构造源串:
1)将请求的URI路径进行URL编码(URI不含host),得到:%2Fuser%2Fget_info;
10
DB3502/T056.3—2020
2)将除“sig”外的所有参数按key进行字典升序排列,排列结果为:access_token,appid,
format,name;
3)将2)中排序后的参数(key=value)用&拼接:access_token=e123456&appid=123456
&format=json&name=jack;
4)进行URL编码(编码时应关注URL编码注意事项,否则容易导致后面签名不能通过验证),
编码结果为:access_token%3De123456%26appid%3D123456%26format%3Djson%26name%3D
jack;
5)将HTTP请求方式、1)以及3)中的到的字符串用&拼接起来,得到源串:
GET&%2Fuser%2Fget_info&access_token%3De123456%26appid%3D123456%26format%3Djs
on%26name%3Djack。
c)第三步:生成签名值:
1)将源串与应用的SecretKey值用&拼接得到整个字符串:
GET&%2Fuser%2Fget_info&access_token%3De123456%26appid%3D123456%26format%3Djs
on%26name%3Djack&1234567890;
2)对其进行MD5计算得到生成签名值:a8c3542c4463fee08337d0ae796bb381。
注:除非接口文档中特别标注了某参数不参与签名,否则除sig外的所有参数都参与签名。
8.5.3登录验证接口
功能说明:获取需要授权的RestAPI时候,需要先获取一个access_token作为权限资源接
口调用的凭证参数。
请求方式:POST。
请求地址:/auth/token。
公共参数:发送请求时应传入公共参数。
业务参数:登录验证服务入参表见表5。
表5登录验证服务入参表
参数名称是否必须类型描述
login_name是string平台用户的登录名
经过加密的平台用户的密码。算法:原密码进行MD5计算后的字
pwd是string
符串末尾追加上应用的SecretKey再进行一次MD5计算
返回参数说明:包含公共返回参数和业务返回参数。登录验证服务出参表见表6。
表6登录验证服务出参表
参数名称描述
access_token获取的AccessToken
expires_inAccessToken的有效期,以秒为单位
8.5.4退出登录接口
功能说明:退出登录的操作,注销access_token。
请求方式:POST。
请求地址:/auth/exit。
公共参数:发送请求时应传入公共参数。
返回报文:公共参数。
11
DB3502/T056.3—2020
8.5.5表码获取接口
功能说明:获取指定表码表的值。
请求方式:GET。
请求地址:/system/get_table_code。
公共参数:发送请求时应传入公共参数。
业务参数:表码获取入参表见表7。
表7表码获取入参表
参数名称是否必须类型描述
表码表对应表ID
0:服务资源开发语言;1:服务资源开发框架;
table_id是string
2:服务资源参数类型;3:单位表码表;
4:服务组别;5:资源要素表码
返回参数说明:包含公共返回参数和业务返回参数。表码获取出参表见表8。
表8表码获取出参表
参数名称描述
label显示值
value表码值
sort排序
8.5.6我的服务接口
功能说明:获取本单位发布的服务列表。第三方应用应根据服务状态和审核状态组装获取不
同的服务列表。
请求方式:GET。
请求地址:/service/get_my_services。
公共参数:发送请求时应传入公共参数。
业务参数:“我的服务”调用入参表见表9。
表9“我的服务”调用入参表
参数名称是否必须类型描述
审核状态(0:未审批;1:中心审批通过;2:提交审核;3:中
review_status否string
心拒绝通过),不传则获取全部状态。
服务状态(0:未测试;1:测试通过;2:测试不通过),不传则
service_status否string
获取全部状态。
service_id否string服务ID
service_name否string服务别名
返回参数说明:包含公共返回参数和业务返回参数。“我的服务”调用出参表见表10。
12
DB3502/T056.3—2020
表10“我的服务”调用出参表
参数名称描述
id记录的主键ID
service_id服务ID
service_name服务别名
service_group服务所属组
create_date发布日期
expiration_date失效日期
review_status审核状态(0:未审批;1:中心审批通过;2:提交审核;3:中心拒绝通过)
service_status服务状态(0:未测试;1:测试通过;2:测试不通过)
is_enabled是否禁用(0:否;1:是;2:暂停)
review_date审核时间
service_type服务类型(0:内置服务;1:原子服务;2:融合服务)
review_opinion审核意见
department服务所属单位
department_cn服务所属单位中文名
authorize_dept授权使用单位
authorize_dept_cn授权使用单位中文名
is_private是否私有(0:否;1:是)
develop_language开发语言
develop_framework开发框架
develop_framework_v开发框架版本号
version服务版本
instruction服务说明
call_directions调用说明
method服务方法名
method_cn服务方法名中文名称
wsdlWSDL地址
concurrent_limit服务并发上限
8.5.7新增、修改服务接口
功能说明:第三方应用新增或者修改自己的服务时,应注意:已经通过审核的不允许更改,
需要更改应联系总控管理员。
请求方式:POST。
请求地址:/service/save_service。
公共参数:发送请求时应传入公共参数。
业务参数:新增、修改服务入参表见表11。
13
DB3502/T056.3—2020
表11新增、修改服务入参表
参数名称是否必须类型描述
记录的主键ID,当为空值时,为新增操作;有值则做修改操
id否string
作
服务ID,自定义后缀的串,平台会给添加,例如,DsWs003
service_id是string
最终存储在平台为:XM.GOV.YZ.DS.DsWs003
service_name是string服务别名
service_group否string服务所属组
expiration_date是string失效日期
授权使用单位,英文逗号将单位ID(单位表码表码值)分隔
authorize_de
温馨提示
- 1. 本站所有资源如无特殊说明,都需要本地电脑安装OFFICE2007和PDF阅读器。图纸软件为CAD,CAXA,PROE,UG,SolidWorks等.压缩文件请下载最新的WinRAR软件解压。
- 2. 本站的文档不包含任何第三方提供的附件图纸等,如果需要附件,请联系上传者。文件的所有权益归上传用户所有。
- 3. 本站RAR压缩包中若带图纸,网页内容里面会有图纸预览,若没有图纸预览就没有图纸。
- 4. 未经权益所有人同意不得将文件中的内容挪作商业或盈利用途。
- 5. 人人文库网仅提供信息存储空间,仅对用户上传内容的表现方式做保护处理,对用户上传分享的文档内容本身不做任何修改或编辑,并不能对任何下载内容负责。
- 6. 下载文件中如有侵权或不适当内容,请与我们联系,我们立即纠正。
- 7. 本站不保证下载资源的准确性、安全性和完整性, 同时也不承担用户因使用这些下载资源对自己和他人造成任何形式的伤害或损失。
最新文档
- 航空器维修质量控制与安全管理模拟试题及答案
- 公用设备运行与维护技术备考习题及答案
- 矿山企业安全管理员安全生产知识考试预测试题及答案
- 公共卫生监测与检验技术备考习题及答案
- 注册机械工程师考试机械制造工艺与设备专项训练题库及答案
- 2026年wps大学考试题库带答案
- 2026年癌痛题库及参考答案
- 银行招聘性格测试真题解析及备考策略及答案
- 2026年金融监管实事题库带答案
- 2026年人力资源管理师一级理论案例分析模拟试卷(含答案)
- TCAV 004-2024 TCAS 900-2024 特殊健康状态儿童预防接种评估门诊与转诊系统建设规范
- 人教版(2024)三年级上册6.6《一个因数末尾有0的乘法》课件
- JGJ52-2006 普通混凝土用砂、石质量及检验方法标准
- 主题班会调整心态缓解压力省公开课一等奖全国示范课微课金奖课件
- 病毒基因组课件
- 2024全国职业院校技能大赛ZZ060母婴照护赛项规程+赛题
- 临床微生物实验室在感控中的角色
- 三年级英语课标解读课件
- 住宅小区安全技术防范系统建设技术规范
- 企业负责人试卷2附有答案
- JJG 882-2019压力变送器
评论
0/150
提交评论