DB3502∕T 056.3-2020 政务信息共享协同平台 第3部分：接入要求

ICS

35.240CCS

L773502/T DB3502/T

056.3—2020政务信息共享协同平台第

3

部分：接入要求The

of

—Part

3：

发布

实施厦门市市场监督管理局 发

布DB3502/T

056.3—2020 前言

................................................................................

III引言

.................................................................................

IV1

...............................................................................

12 规范性引用文件

.....................................................................

13 术语和定义

.........................................................................

14 缩略语

.............................................................................

25 网络链路架构

.......................................................................

26 生产方接入

.........................................................................

3接入服务接口资源

...............................................................

3接入数据文件资源

...............................................................

4接入数据库表资源

...............................................................

4接入数据流资源

.................................................................

57 消费方接入

.........................................................................

6使用服务接口资源

...............................................................

6使用数据文件资源

...............................................................

7使用数据库表资源

...............................................................

7使用数据流资源

.................................................................

88 区级平台接入

.......................................................................

8区级平台接入概述

...............................................................

8区级平台接入申请

...............................................................

8调用平台服务接口流程

...........................................................

9公共参数说明

..................................................................

10平台对接接口

..................................................................

10附录

A（资料性） 协同平台错误码表....................................................

21附录

B（资料性） 共享服务资源调用示例................................................

22B.1 调用步骤说明

..................................................................

22B.2 Java

语言版本调用示例..........................................................

22附录

C（资料性） 区级平台接入规范报文示例............................................

28C.1

请求报文示例

..................................................................

28C.2

退出登录接口

..................................................................

28C.3

表码获取接口

..................................................................

29C.4

“我的服务”接口

..............................................................

30C.5

新增、修改服务接口

............................................................

32C.6

获取服务详细信息接口

..........................................................

33C.7

服务提交审核接口

..............................................................

35C.8

获取可申请的外部服务列表接口

..................................................

36C.9

申请外部服务接口

..............................................................

38DB3502/T

056.3—2020参考文献..............................................................................

39IIDB3502/T

056.3—2020 本文件按照GB/T

1.1—2020《标准化工作导则

第1部分：标准化文件的结构和起草规则》的规定起草。本文件为DB3502/T

056《政务信息共享协同平台技术规范》的第3部分。DB3502/T

056已发布了以下部分：——第

1

部分：总体设计；——第

2

部分：资源管理；——第

3

部分：接入要求；——第

4

部分：二次开发。本文件是在DB3502/Z

—2016《政务信息共享协同平台技术规范

第3DB3502/Z

033.3—辑性改动外，主要技术变化如下：a)

6

章，033.3—2016

7

章）；b)

7

章，033.3—2016

6

章、第

8

章）；c)

8

章，DB3502/Z033.3—2016

9

章）；d)

增加接入日志记录要求，建立调用方与平台的对账机制（见

.5）；e)

完善带

TLS

的服务资源接入要求说明（见

，DB3502/Z

033.3—2016

的

7.2.3f)

增加服务接入

地址释义（见

.1g)

增加平台错误码表（见附录

Ah)

按照当前接入要求提供示例代码（见附录

B、附录

C，DB3502/Z

033.3—2016

的附录

BC）。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件由厦门市工业和信息化局提出。本文件由厦门市工业和信息化局归口。本文件起草单位：厦门畅享信息技术有限公司、厦门市标准化研究院、厦门市信息中心。本文件主要起草人：郭劲军、郭望、傅楚隆、揭英杰、吴宸勖、陈尚峰、卢淼先、闫焕友、李童、蔡跃华、张金梅、刘姗姗、吕志仁、赖炜炜、巫晓强、杨远军、朱永上、彭明剑。IIIDB3502/T

056.3—2020DB3502/T

入要求、二次开发的技术标准，拟由四个部分构成。——第

1

部分：总体设计。目的在于确立平台关键技术路线和软件系统的组织形式，确保平台总体架构满足国家对政务信息交换与共享的要求，明确平台内主要功能模块和模块间的逻辑关系，避免“过度建设”并确保“必要建设”。——第

2

部分：资源管理。目的在于规范平台所支持的多种资源类型、协议标准、提供方式，为平台对外服务的兼容性提供保障；明确平台不同类型资源的属性，统一属性分类，为平台对外服务的通用性提供保障；针对资源生产、资源注册、资源测试、资源申请、资源调用、资源目录、资源检索、资源版本、资源安全等操作提出全生命周期管理要求，为平台对外服务的可用性提供保障。——第

3

部分：接入要求。目的在于将平台对外接口标准化，明确接口在安全性、完备性、一致性、易用性、稳定性方面要求，进一步提升平台对外提供服务的能力和质量，并从网络接入、平台资源生产方、平台资源消费方、区级平台接入等方面，明确接入的实现方式，为保障平台建设质量及拓展平台应用范围提供技术支撑。——第

4

部分：二次开发。目的在于规范平台提供二次开发的工作方式、对扩展模块管理方式，为后续平台业务流程及插件的完善提供统一标准，既避免了平台直接耦合上层各类业务，又允许不同部门结合特定业务需要，在授权范围内扩展平台功能。IVDB3502/T

056.3—2020

1范围本文件规定了生产方、消费方、区级平台接入政务信息共享协同平台的技术要求。统接入时参照使用。2规范性引用文件文件。DB3502/T

056.1—2020 政务信息共享协同平台

第1部分：总体设计DB3502/T

056.2—2020 政务信息共享协同平台

第2部分：资源管理3 术语和定义DB3502/T

056.1—2020、DB3502/T

056.2—2020界定的以及下列术语和定义适用于本文件。请求方

ID requester

identity协同平台为每个服务消费方分配的唯一标识。服务方

ID services

identity协同平台为每个服务生产方分配的唯一标识。融合服务 composite

基于服务流程引擎，融合多个原子服务，实现将多个细颗粒度服务，融合为一个粗颗粒度服务。请求接入requester

按照协同平台标准，服务消费方接入到本平台，并且调用其他单位服务的过程。服务接入services

按照协同平台标准，服务生产方接入到本平台，对外服务的过程。消息（用于编程语言） message(in

programming

languages)对象进行其各一次运算之一的一次请求。[来源：GB/T

—，15.09.06]DB3502/T

056.3—2020请求报文 request

服务消费方向协同平台发出的报文。响应报文 response

协同平台返回给服务消费方的结果报文。4 缩略语下列缩略语适用于本文件。API：应用程序编程接口（Application

Interface）APP：应用程序（APPlication）CPU：中央处理器（

Processing

Unit）GB：计算机存储单位，吉字节（GigaByte）HTTP：超文本传输协议（Hyper

Text

Transfer

Protocol）ID：唯一编码（Identity

Document）JSON：基于“JavaScript”语言形式的数据对象表达方式（JavaScript

Notation）RTSP：实时流传输协议（Real

Time

Streaming

Protocol）REST：表述性状态转移（REpresentational

State

Transfer）SDK：软件开发工具包（Software

Development

Kit）SFTP：SSH文件传输协议（SSH

File

Transfer

Protocol）SOAP：简单对象访问协议（Simple

Access

Protocol）SSL：安全套接层（

Sockets

Layer）TCP：传输控制协议（Transmission

）TLS：传输层安全协议（

Layer

Security）UDP：用户数据报协议（

Datagram

Protocol）UTF-8：8的可变长度字符编码（

Unicode

Format）URL：统一资源定位系统（Uniform

Resource

）WSDL：Web服务器描述语言（Web

Service

Language）XML：扩展性标识语言（

）XSD：结构定义（XML

Schema

Definition）5 网络链路架构图1 网络链路架构TransferHTTP

Message

SOAP

or

Identity

or

WS-Addressing

Service

XML

WSDL

DB3502/T

056.3—2020网络链路架构见图

1。分控中心应采用独立的服务器作为接入前置机，接通与总控中心服务器的一道或多道防火墙等网络安全设备。基本配置要求如下：a)

网络要求：局域网接入速度应大于

Mb/s；b)

前置机配置要求：

主频不低于

4

4

G，采用

Linux或自主可控操作系统；c)

部署接入前置机应由部门端和总控中心双方共同管理。前置机上主要部署分控中心所需的软件环境，不宜部署其它应用。6 生产方接入接入服务接口资源6.1.1 服务接入流程服务接入涉及到两类用户，分控管理员和总控管理员。表，并按需发起申请。含义参照DB3502/T

056.2—2020中的说明。6.1.2 技术要求Web

.1 接入到平台的

服务应满足表

1

的版本要求。表1 Web

版本要求.2 接入本平台的服务方默认只支持基本数据类型，以消除由于使用不同语言、不同框架实现Web

XML

string.2 接入本平台的服务方默认只支持基本数据类型，以消除由于使用不同语言、不同框架实现式接入。 REST

服务接入服务的报文格式及交换形式满足或传输协议，采用GET或POST方法提起请求，采用JSON格式、XML或自定义纯文本作为请求或回应报文的载体格式。 带

TLS

的服务资源接入DB3502/T

056.3—2020协同平台支持采用TLS1.1b)和方式，资源在注册过程中应提供相应的身份认证证书。a)

不做身份认证仅加密报文。b)

加密报文且实现请求方通过证书验证服务方，服务方不验证请求方。c)

加密报文且请求与服务方相互验证对方身份三种安全交换方式。接入数据文件资源6.2.1 数据文件资源接入流程数据文件资源接入涉及到两类用户，分控管理员和总控管理员。表，并按需发起申请。ID型、共享范围、上传方式、资源描述、资源文档。字段含义参照DB3502/T

—中5.1的说明。6.2.2 技术要求数据文件资源应符合以下要求，以提供稳定的数据资源共享服务：a)

文件大小单文件应不超过

2GB享；b)

文件目录的目录层级应不超过

3

层；c)

SFTP

协议传输时应将目录名、文件名指定为

UTF-8

编码格式。接入数据库表资源6.3.1 数据库表资源接入流程数据库表资源接入涉及到两类用户，分控管理员和总控管理员。表，并按需发起申请。资源描述、资源文档。字段含义参照DB3502/T

—2020中的说明。6.3.2 技术要求 数据库类型协同平台支持Oracle、、SqlServer等关系型数据库的数据库类型的库表资源共享。 数据库表结构数据库表类型共享资源应符合以下要求：a)

数据库表名应不超过

30

个字符；b)

数据库表都应有唯一的主键；c)

数据库表都应有描述数据更新的时间戳字段；ORACLEMySQLNUMBERTINYINTSMALLINTMEDIUMINTINTBIGINTFLOATDOUBLEDECIMALYEARDATEDATETIMESTAMPTIMEDATETIMETIMESTAMPCHARCHARVARCHAR2VARCHARCLOBTINYTEXTTEXTMEDIUMTEXTLONGTEXTBLOBTINYBLOBBLOBMEDIUMBLOBLONGBLOBDB3502/T

056.3—2020d)

数据库表的字段类型应在可共享字段类型范围内，暂不支持

CLOB、BLOB

体见表

2。表2 数据库表支持字段类型说明接入数据流资源6.4.1数据流资源接入流程数据流资源接入涉及到两类用户，分控管理员和总控管理员。列表，并按需发起申请。期、共享类型、共享范围、协议类型、服务IP地址、服务端口、资源描述、资源文档。字段含义参照DB3502/T

056.2—2020中的说明。6.4.2 技术要求协同平台支持基于、MQ、Redis、HTTP、RTSP等协议传输的资源。DB3502/T

056.3—20207 消费方接入使用服务接口资源7.1.1 使用服务接口接入流程消费方使用服务接口接入流程包括两步：第一步是分控管理员填写申请使用服务的信息，总台的请求接口，获取结果数据。 申请服务所需填写的主要信息包括：a)

资源

DB3502/T

—2020

第

5

章的要求；b)

申请

：用于在协同平台表征本次申请行为的唯一英文标记；c)

联系人：指定请求申请目标服务的联系人信息；d)

联系人电话：指定请求申请目标服务的联系人电话；e)

授权业务：指定请求申请目标服务所用的授权业务；f)

授权应用系统：指定请求申请目标服务所用的授权应用系统；g)

使用频率：指定请求申请目标服务所用的最高频率；h)

使用并发量：指定请求申请目标服务所用的最高并发量；i)

其他技术请求：指定请求申请目标服务所用的其他技术请求。7.1.2 接入方式 请求接入协同平台支持基于风格URL见附录A。 消费方基于

REST

.1 协同平台服务资源宜表示为

REST

风格的

URL

地址。格式及说明见图

2。.2 协同平台服务资源访问前需通过

URL

获取凭证令牌才可访问资源。格式及说明见图

3。.3 协同平台服务资源短码通过在协同平台申请的资源详情下载使用手册来查阅。授权短码代表应用与共享服务资源的对应关系，不同应用对同个可访问授权资源的授权短码是不同的。.4 通过请求协同平台服务资源来完成的政务业务，

格式详见图

2。.5 协同平台记录被调用日志时，需记录办件编码信息；调用方记录调用日志时，需记录办件编码信息。图2 REST

风格服务资源

地址说明DB3502/T

056.3—2020图3 凭证令牌获取

地址说明 消费方基于

SDK

的接入SDKREST例见附录B。使用数据文件资源7.2.1 使用数据文件资源接入流程 消费方使用数据文件资源接入流程包括两步：a)

该数据文件资源的权限；b)

第二步：消费方或消费方的应用系统通过

SFTP

协议或指定的文件接收目录，获取相应的数据文件资源。 申请数据文件资源所需填写的主要信息包括：a)

资源

DB3502/T

—2020

第

5

章的要求；b)

申请

：用于在协同平台表征本次申请行为的唯一英文标记；c)

联系人：指定请求申请目标数据文件资源的联系人信息；d)

联系人电话：指定请求申请目标数据文件资源的联系人电话；e)

授权业务：指定请求申请目标数据文件资源所用的授权业务；f)

授权应用系统：指定请求申请目标数据文件资源所用的授权应用系统；g)

SFTP

和本地目录两种方式。SFTP

SFTP

地址、用户名和密码，本地目录接收指定服务器的接收目录。7.2.2 接入方式按照申请信息中的相关要求，初始化对应的SFTP用户及目录。使用数据库表资源7.3.1 使用数据库表资源流程 消费方使用数据库表资源流程包括三步：a)

据库表的权限；b)

第二步：总控管理员配置数据库交换方案，将数据同步到前置库或推送到业务库；c)

第三步：消费方按要求从前置库或本地业务库获取结果数据。 申请服务所需填写的主要信息包括：DB3502/T

056.3—2020a)

资源

DB3502/T

—2020

第

5

章的要求；b)

申请

：用于在协同平台表征本次申请行为的唯一英文标记；c)

联系人：指定请求申请目标数据库表资源的联系人信息；d)

联系人电话：指定请求申请目标数据库表资源的联系人电话；e)

授权业务：指定请求申请目标数据库表资源所用的授权业务；f)

授权应用系统：指定请求申请目标数据库表资源所用的授权应用系统；g)

同步字段：指定请求申请数据库表资源要同步的字段集；h)

接收方式：指定请求申请数据库表资源的接收方式，包含前置库读取或推送到本地业务库；i)

库类型、字符集、数据库参数、数据库表。7.3.2 接入方式按照申请信息中的相关要求，初始化对应的数据库用户及库表信息。使用数据流资源7.4.1 使用数据流资源流程 消费方使用数据流资源流程包括两步：a)

权限；b)

第二步：消费方的应用系统构建请求报文，调用协同平台的请求接口，获取结果数据。 申请服务所需填写的主要信息包括：a)

资源

DB3502/T

—2020

第

5

章的要求；b)

申请

：用于在协同平台表征本次申请行为的唯一英文标记；c)

联系人：指定请求申请目标数据流资源的联系人信息；d)

联系人电话：指定请求申请目标数据流资源的联系人电话；e)

授权业务：指定请求申请目标数据流资源所用的授权业务；f)

授权应用系统：指定请求申请目标数据流资源所用的授权应用系统；g)

授权

：指定请求申请目标数据流资源授权可访问的

IP

地址。7.4.2 接入方式按照目标数据流资源指定的数据访问协议，访问协同平台开放的数据流资源端口。8 区级平台接入区级平台接入概述放的资源。协同平台提供基于

形式的开发接口。接入报文示例见附录C。区级平台接入申请8.2.1 区级平台接入之前，应在市政务信息共享协同平台管理系统发起接入申请。其中需要选择所需DB3502/T

056.3—2020要协同平台给予提供的权限接口，可选范围包括：a)

布的服务列表；b)

获取可申请服务接口：获得查看市级平台所有可向区级平台开放的服务目录列表；c)

发布服务接口：调用该接口，可向市级平台开放区级平台上的服务资源；d)

申请服务接口：调用该接口，可向市级平台申请区级平台所需的服务资源；e)

修改服务接口：修改已经发布到市级平台的服务接口的部分配置；f)

调用服务接口：调用已通过“申请服务接口”，并完成并通过申请的市级平台服务。8.2.2 审核通过后，指定应用即可上线调用指定的市级平台接口。8.2.3 应用审核通过后，应获得由市级平台自动分配给本应用的且不可更改的

App

ID

和

等属性：a)

App

ID：由系统生成，作为应用的唯一标识；b)

Secret

Key：由系统生成，用来验证应用合法性的加密串。8.2.4 具体操作流程如下：a)

在管理页面填写基本信息，应包括：应用名称、简介，并选择待申请使用的接口范围；b)

信息填写完成并提交审核后，进入审核阶段；c)

平台管理员审核通过，可获得相应权限。调用平台服务接口流程8.3.1 拥有平台用户帐号和应用

App

和

Secret

后，应用应凭借二者调用资源，调用时序见图4。8.3.2 调用平台中不需要权限的

API

Token

API

Access

Token调用时将

Token

8

格式。图4 平台服务接口调用时序appidstringIDAPPsigstringsigformatstringJSONXMLaccess_tokenstringtokenretmsgdataDB3502/T

056.3—2020公共参数说明8.4.1 平台服务调用接口公共入参表见表

3。各项入参应进行

编码。表3 平台服务调用接口公共入参表8.4.2 8.4.2 平台服务调用公共出参表见表

4。其余业务返回参数封装在

data

字段中，由各个

表4 平台服务调用公共出参表平台对接接口8.5.1 签名生成在使用HTTP协议请求接口时，为了确保应用与API服务器之间的安全通信，防止Secret

Key盗用，API的私钥Secret

API到请求参数中。8.5.2 签名算法待签名的源串包括

3

部分内容并用“&”字符拼接：HTTP

请求方式

&

urlencode(uri)

&urlencode(a=x&b=y&...)。在源串的末尾追加上应用的

Secret

Key

的值。 下面以/user/get_info

为例描述签名算法。a)

第一步：原始请求信息：1)

HTTP

请求方式：GET；2)

请求的

URI

路径（不含

）：/user/get_info；3)

请求参数：appid=123456&format=json&name=jack&access_token=e123456。b)

第二步：构造源串：1)

将请求的

路径进行

编码（

host），得到：；10login_namestringpwdstring

Secret

access_token

Access

expires_inAccess

DB3502/T

056.3—20202)

sig

key

access_token，appid，format，name；3)

将

2）中排序后的参数用&拼接：&format=json&name=jack；4)

进行

URL

URL

编码结果为：jack；5)

将

HTTP

请求方式、1）以及

3）中的到的字符串用&拼接起来，得到源串：GET&%2Fuser%2Fget_info&access_token%3De123456%26appid%3D123456%26format%3Djson%26name%3Djack。c)

第三步：生成签名值：1)

将源串与应用的

Secret

&拼接得到整个字符串：GET&%2Fuser%2Fget_info&access_token%3De123456%26appid%3D123456%26format%3Djson%26name%3Djack&1234567890；2)

对其进行

计算得到生成签名值：a8c3542c4463fee08337d0ae796bb381。sig8.5.3 登录验证接口 功能说明：获取需要授权的

Rest

API

时候，需要先获取一个

access_token

作为权限资源接口调用的凭证参数。 请求方式：POST。 请求地址：/auth/token。 公共参数：发送请求时应传入公共参数。 业务参数：登录验证服务入参表见表

5。表5 登录验证服务入参表 返回参数说明：包含公共返回参数和业务返回参数。登录验证服务出参表见表

6。 返回参数说明：包含公共返回参数和业务返回参数。登录验证服务出参表见表

6。8.5.4 退出登录接口

功能说明：退出登录的操作，注销

access_token。

请求方式：POST。

请求地址：/auth/exit。

公共参数：发送请求时应传入公共参数。

返回报文：公共参数。11review_statusstringstringservice_idstring

IDservice_namestringtable_idstring

IDlabelvaluesortDB3502/T

056.3—20208.5.5表码获取接口

功能说明：获取指定表码表的值。

请求方式：GET。

请求地址：/system/get_table_code。

公共参数：发送请求时应传入公共参数。

业务参数：表码获取入参表见表

7。表7表码获取入参表 返回参数说明：包含公共返回参数和业务返回参数。表码获取出参表见表

8。 返回参数说明：包含公共返回参数和业务返回参数。表码获取出参表见表

8。8.5.6 我的服务接口 功能说明：获取本单位发布的服务列表。第三方应用应根据服务状态和审核状态组装获取不同的服务列表。 请求方式：GET。 请求地址：/service/get_my_services。 公共参数：发送请求时应传入公共参数。 业务参数：“我的服务”调用入参表见表

9。表9 “我的服务”调用入参表 返回参数说明：包含公共返回参数和业务返回参数。“我的服务”调用出参表见表

10。id

IDservice_id

IDservice_nameservice_groupcreate_dateexpiration_datereview_statusis_enabledreview_dateservice_typedepartmentdepartment_cnauthorize_dept_cnis_privatedevelop_frameworkdevelop_framework_vversioninstructioncall_directionsmethodmethod_cnwsdlWSDL

DB3502/T

056.3—2020表10“我的服务”调用出参表8.5.7 新增、修改服务接口 功能说明：第三方应用新增或者修改自己的服务时，应注意：已经通过审核的不允许更改，需要更改应联系总控管理员。 请求方式：POST。 请求地址：/service/save_service。公共参数：发送请求时应传入公共参数。 业务参数：新增、修改服务入参表见表

。13idstring

IDservice_idstring

IDDsWs003XM.GOV.YZ.DS.DsWs003service_namestringservice_groupstringexpiration_datestringstring

ID

is_private

is_privatestringstringdevelop_frameworkstringdevelop_framework_vstringversionstringinstructionstringmethodstringmethod_cnstringwsdlstringWSDL

stringdocstring

Base64

doc_namestringdoc_typestringxsdstring

xsd_namestring

output_directionsstringstringoutput_typestringinputsstring

json

keywordstring”）隔开fwtclxstringinput_namestringstringinput_typestringDB3502/T

056.3—2020表11 新增、修改服务入参表 inputs

的值是一组输入参数对象数组组成的

json

串，新增、修改服务

入参表见表表12 新增、修改服务

inputs

入参表14id

IDservice_id

IDservice_nameservice_groupcreate_dateexpiration_datezy_bm

Idzy_mcreview_statusis_enabledreview_dateservice_typedepartmentdepartment_cnidstring

IDneed_docstring

base64

need_xsdstring

base64

service_idstring

IDtheir_domain_idstring

idinput_sortstring输入序的排序，用两位数字符串表示01”，“02”，“18DB3502/T

056.3—2020表12（续）8.5.8 获取服务详细信息接口

功能说明：获取服务的详细信息。

请求方式：GET。

请求地址：/service/get_service_info

公共参数：发送请求时应传入公共参数。

业务参数：获取服务详细信息入参表见表

13。表13获取服务详细信息入参表 返回参数说明：包含公共返回参数和业务返回参数。获取服务详细信息出参表见表

14。 返回参数说明：包含公共返回参数和业务返回参数。获取服务详细信息出参表见表

14。15authorize_dept_cnis_privatedevelop_frameworkdevelop_framework_vversioninstructioncall_directionsmethodmethod_cnwsdlWSDL

doc

Base64

doc_namedoc_typexsd

xsd_name

output_directionsoutput_typeinputs

json

keywordfwtclxrestInputOutputREST

input_namestringstringinput_typestringinput_sortstring参数输入顺序的排序值，请用两位的数字字符串表示，如：01”，“02”，“18DB3502/T

056.3—2020表

14（续） inputs

的值是一组输入参数对象数组组成的

json

出参表见表表15 获取服务详细信息

出参表 restInputOutput的值是一组maprestInputOutput出参表见表16。versionstringREST

urlstringURLmethodstringget/postheadstringreq_encodingstringrsp_encodingstringreq_body_typestringrsp_body_typestringreq_bodystringrsp_bodystringidstring

IDparam_valuestring参数值组成的

json

串，组成规则为参数名为

key，参数值value]}service_idstring

IDid

IDDB3502/T

056.3—2020表16 获取服务详细信息

出参表8.5.9 服务提交审核接口

功能说明：对发布的服务进行提交审核。

请求方式：POST。

请求地址：/service/submit_service。

公共参数：发送请求时必须传入公共参数。

业务参数：服务提交审核接口入参表见表

17。表17服务提交审核接口入参表 返回参数说明：包含公共返回参数和业务返回参数。服务提交审核接口出参表见表

18。 返回参数说明：包含公共返回参数和业务返回参数。服务提交审核接口出参表见表

18。8.5.10 获取可申请的外部服务列表接口

功能说明：获取其他部门单位的服务列表。

请求方式：GET。

请求地址：/service/get_external_services。

公共参数：发送请求时必须传入公共参数。

业务参数：获取可申请的外部服务接口入参表见表

19。17idIDservice_idIDservice_nameservice_groupcreate_dateexpiration_datereview_statusis_enabledreview_dateservice_typedepartmentdepartment_cnauthorize_dept_cnis_privatedevelop_frameworkdevelop_framework_vversioninstructioncall_directionsmethodmethod_cnwsdlWSDLcreate_datestring

20130813departmentstringservice_idstring

IDservice_namestringlist_typestring

DB3502/T

056.3—2020表19获取可申请的外部服务接口入参表 表20获取可申请的外部服务接口出参表18idIDservice_idIDservice_nameexpiration_dateservice_typedepartmentdepartment_cnauthorize_dept_cnis_privatemethodmethod_cncreate_datestring20130813departmentstringservice_idstringIDservice_namestringlist_typestringhas_applyDB3502/T

056.3—2020表20（续）8.5.11获取申请过的外部服务列表接口

功能说明：获取其他部门单位的服务列表。

请求方式：GET。

请求地址：/service/get_apply_services。

公共参数：发送请求时应传入公共参数。

业务参数：获取申请过的外部服务列表接口入参表见表

。表21 获取申请过的外部服务列表接口入参表 见表

表22 获取申请过的外部服务列表接口出参表1919wsdlWSDLsq_idIDsq_timesq_businesssq_start_timesq_end_timesq_review_opinionsq_frequencysq_opinionidstringIDsq_start_timestring14sq_end_timestring14sq_businessstringsq_frequencystring24sq_opinionstringstringsqidIDDB3502/T

056.3—2020表22（续）8.5.12 申请外部服务接口

功能说明：申请使用外部服务。

请求方式：POST。

请求地址：/service/apply_service。

公共参数：发送请求时应传入公共参数。

业务参数：申请外部服务接口入参表见表

23。表23 申请外部服务接口入参表 返回参数：包含公共返回参数和业务返回参数，申请外部服务接口出参表见表

24。 返回参数：包含公共返回参数和业务返回参数，申请外部服务接口出参表见表

24。201133005

1133006

ID1136007

ID

1136008

ID

1136009

ID

1136010

ID

1136011

ID

1136012

code

11360151236001133530313353041335305SFTP

1335306

ID

1335307SFTP

133531713353181338004

21310002136012223521722360142331018

233101923310202335308

SFTP

233530923353102335311

SFTP

2335312SFTP

243600524360132935301

SFTP

3136013DB3502/T

056.3—2020

附 录 A（资料性）协同平台错误码表协同平台错误码见表A.1。表A.1表A.1

协同平台错误码表DB3502/T

056.3—2020

附 录 B（资料性）共享服务资源调用示例B.1 调用步骤说明调用基本步骤如下：a)

通过协同平台的授权地址获取资源动态凭证令牌；b)

通过协同平台的服务调用地址访问相应的服务，并获取返回结果。B.2 Java

语言版本调用示例以下为Java语言SDK请求平台带有TLS的Web

Servives服务的示例代码。package

import

import

import

import

import

import

import

import

import

import

import

import

import

import

import

import

.ssl.SSLContext;import

.ssl.SSLSession;import

import

/**

*/public

22DB3502/T

056.3—2020

String

ID

String

String

"000";

String

static

main(String[]

//

("{\"a\":\"a\"}");

////

ID

queryTokenUrl

//

access_token

expires_in//TODO

access_token

accessTokenInfo

//

//

POST

result

//TODO

result.toString("UTF-8")

System.out.println(result.toString("UTF-8"));

//TODO

{"message":"

status

返回的异常信息请见

e)

//23DB3502/T

056.3—2020

e)

//

//

e)

//

@param

@param

{"access_token":"","expires_in":

PoseidonException*/

JSONObject

url,

timeOut)

IOException,

result

timeOut);

accessTokenInfo

JSONObject.parseObject(result.toString());

@param

@param

PoseidonException*/

static

get(String

IOException,

result

"GET",

24DB3502/T

056.3—2020

@param

@param

@param

*/

static

url,

String

param,

throws

IOException,

result

"POST",

ByteArrayOutputStream

String

timeOut)

IOException,

connection

1000);

!=

outputStream

outputStream.write(requestParam.getBytes("UTF-8"));//

200)

result

25DB3502/T

056.3—2020

result.toString("UTF-8"));

result

@param

*/

ByteArrayOutputStream

throws

==

ByteArrayOutputStream(0);

buffer

0,

out;

*/

void

throws

trustAllCerts

void

s)

throws

26DB3502/T

056.3—2020

void

s)

throws

CertificateException

X509Certificate[]

new

sslContext

SSLContext.getInstance("TLS");

verify(String

SSLSession

//

hostname

*/

static

Exception

http

*/

PoseidonException(int

String

getResponseCode()

responseCode;27DB3502/T

056.3—2020

附 录 C（资料性）区级平台接入规范报文示例C.1 请求报文示例POST

HTTP/1.1Content-Type:

Content-Length:

&login_name=admin&pwd=9iaaaabbdsss&sig=75897972f153d6509988227fa8bba9abC.1.1 返回报文示例C.1.2 JSON格式返回报文示例"access_token":"10000f771b2000-222209506",C.1.3 XML格式返回报文示例<?xml

encoding="UTF-8"?><Result>

access_token>10000f771b2000-222209506</item>

</Result>C.2退出登录接口C.2.1 请求报文示例POST

/auth/exit

Content-Type:

Content-Length:

28DB3502/T

056.3—2020

&access_token=e123456&sig=bc529866f252b086db2b40f22f06aaa4C.2.2返回报文示例C.2.2.1JSON

格式返回报文示例

C.2.2.2 XML

格式返回报文示例<?xml

encoding="UTF-8"?><Result><msg>ok</msg><data></data></Result>C.3 表码获取接口C.3.1请求报文示例POST

Content-Type:

application/x-www-form-urlencodedContent-Length:

&access_token=e123456&table_id=1&sig=e473e175162b14bf52e321cff4c5e52dC.3.2 返回报文示例C.3.2.1JSON

格式返回报文示例

:["label":

","value":

"1",},"label":

","value":

"2",}]29DB3502/T

056.3—2020C.3.2.2 XML

格式返回报文示例<?xml

encoding="UTF-8"?><Result>

value

sort

value

sort</Result>C.4“我的服务”接口C.4.1请求报文示例POST

HTTP/1.1Content-Type:

application/x-www-form-urlencodedContent-Length:

&access_token=e123456&review_status=0&service_status=0&sig=e473e175162b14bf52e321cff4c5e52dC.4.2 返回报文示例C.4.2.1返回

JSON

格式报文示例

:[

"XM.GOV.YZ.DS.DsWs003",

"DsWs003",

30DB3502/T

056.3—2020"review_status":

"1",

"0",

"1",

",

"RS,GA",

",

"0",

"Java",

"1.0","version":

"returnString","method_cn":

"100"C.4.2.2XML

格式返回报文示例<?xml

encoding="UTF-8"?><Result><msg>ok</msg>

service_id

service_name

service_group></item>

expiration_date

is_enabled

review_date

service_type

31DB3502/T

056.3—2020

department

department_cn

authorize_dept_cn</item>

is_private

develop_framework_v>1.0</item>