DB13/T 2709-2018 法人和其他组织统一社会信用代码证数据库访问服务接口技术规范

ICS03.100.01

A02

DB13

河北省地方标准

DB13/T2709—2018

法人和其他组织统一社会信用代码数据库

访问服务接口技术规范

2018-04-09发布2018-05-09实施

河北省质量技术监督局发布

DB13/T2709—2018

前言

本标准按照GB/T1.1-2009给出的规则起草。

本标准由河北省质量技术监督局提出。

本标准由河北省服务标准化技术委员会（SAHB/TC264）归口。

本标准起草单位：河北省标准化研究院、石家庄宇邦软件科技有限公司。

本标准起草人：阎占辉、董世涛、李虓峰、高龙、于潇、闫志强、李英君、孙明立、李会、孙家

田。

I

DB13/T2709—2018

法人和其他组织统一社会信用代码数据库

访问服务接口技术规范

1范围

本标准规定了法人和其他组织统一社会信用代码数据库访问服务接口（以下简称统一代码接口）

的术语、定义和缩略语、统一代码接口框架、统一代码接口要求、统一代码接口服务数据项和统一代

码接口调用状态信息。

本标准适用于政府部门以接口方式进行的统一社会信用代码数据库信息共享应用。

2规范性引用文件

下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅注日期的版本适用于本文

件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。

GB/T2260中华人民共和国行政区划代码

GB/T4754国民经济行业分类

GB32100法人和其他组织统一社会信用代码编码规则

3术语、定义和缩略语

3.1术语和定义

下列术语和定义适用于本文件。

3.1.1

接口interface

体现一个实体行为特征的具体名称的操作集。

3.1.2

请求request

接口用户向接口发出的一次调用申请。

3.1.3

响应response

接口向接口用户返回请求的操作结果。

3.1.4

包体entity-body

数据传输中的实体主体部分。

3.2缩略语

下列缩略语适用于本文件。

1

DB13/T2709—2018

HTTPS基于安全套接字的超文本传输协议（Securehypertexttransferprotocol）

XML可扩展标识语言（Extensiblemarkuplanguage）

JSONJS对象标记(JavaScriptobjectnotation)

4统一代码接口框架

4.1许可和调用

4.1.1接口用户向接口提供方提交使用申请，用户申请信息包括：

a)机构统一社会信用代码；

b)机构名称；

c)用于实现应用接口功能的设备的IP地址；

d)申请使用期限；

e)申请使用数据项。

4.1.2接口提供方收到申请后，生成许可信息反馈给接口用户，许可信息包括：

a)机构统一社会信用代码；

b)机构名称；

c)用于实现应用接口功能的设备的IP地址；

d)申请使用期限；

e)用户账号；

f)用户密码；

g)接口地址。

4.1.3接口用户在调用接口时，应提供被授予的许可信息。

4.1.4接口在接收到请求后，校验接口用户许可信息中用于实现应用接口功能的设备的IP地址和申

请使用期限的有效性、用户账号和用户密码的合法性，检验通过后，执行请求，返回响应内容。

4.2应用模型

统一代码接口应用模型见图1。

请求

接

口接

用口

户响应

图1统一代码接口应用模型

2

DB13/T2709—2018

5统一代码接口要求

5.1接口定义

统一代码接口定义见表1。

表1统一代码接口定义

定义说明

StringTydm_sh_service(stringlicence,1.Tydm_sh_service为约定的接口名称。

stringcond_information,2.license为许可参数(见5.3)。

stringrepl_packagetype)3.cond_information为条件参数(见5.4)。

4.repl_packagetype为返回结果数据包格式参数(见5.5)。

5.接口返回结果见5.6。

5.2基本约定

5.2.1传输协议

采用HTTPS作为传输协议。

5.2.2地址格式

接口地址由接口提供方提供，格式为：https://xxx.xxx.xxx.xxx/services_path/service_name。

其中：xxx.xxx.xxx.xxx表示接口所在的服务器的有效地址；services_path表示接口的发布路径，

由接口提供方命名；service_name表示约定的接口名称，由接口提供方命名。

5.2.3安全性

接口用户以接口提供方授权的许可为凭据调用接口。

5.2.4调用方法

统一代码接口调用方法实例参见附录A。

5.3许可参数

5.3.1内容组成

许可参数由一组用户信息组成。

5.3.2包体标记及含义

许可参数包体标记及含义说明见表2。

3

DB13/T2709—2018

表2许可参数包体标记及含义

信息类别标记字符类型及长度含义说明

tydmnvarchar(18)机构统一社会信用代码---

jgmcnvarchar(400)机构名称---

appkeynvarchar(8)用户账号---

用户信息appsecretnvarchar(10)用户密码---

ipnvarchar(15)被授权应用接口的设备的IP地址---

startdatenvarchar(10)使用期限开始时间