T/YNBX 600.3-2026 云南省电子证照数据共享技术服务规范 第3部分：服务接口

　　ICS 35.240.99 CCS L 67

　　团 体 标 准

　　T/YNBX 600.3—2026

　　云南省电子证照数据共享技术服务规范

　　第 3 部分：服务接口

　　2026 - 02 - 10 发布

　　

　　2026 - 03 - 01 实施

　　云南省标准化协会 发 布

　　T/YNBX 600.3—2026

　　目 次

　　前言 II

　　1 范围 1

　　2 规范性引用文件 1

　　3 术语和定义 1

　　4 缩略语 1

　　5 接入要求 1

　　5.1 接入内容 2

　　5.2 接入方式 2

　　6 身份认证 2

　　7 制证 2

　　7.1 制证流程 3

　　7.2 制证接口参数 3

　　8 用证 6

　　8.1 用证流程 6

　　8.2 用证接口参数 6

　　附 录 A 13

　　附 录 B 15

　　附 录 C 19

　　参考文献 28

　　I

　　T/YNBX 600.3—2026

　　前 言

　　本文件按照GB/T 1.1—2020《标准化工作导则 第 1 部分：标准化文件的结构和起草规则》 的规定起草。

　　本文件是 T/YNBX 600《云南省电子证照数据共享技术服务规范》的第 3 部分。T/YNBX 600 分为以下 4 部分：

　　——第 1 部分：总体要求;

　　——第 2 部分：数据目录;

　　——第 3 部分：服务接口;

　　——第4 部分：数据汇聚及共享应用。

　　请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。

　　本文件由云南省政务服务中心提出。

　　本文件由云南省标准化协会归口。

　　本文件起草单位：云南省政务服务中心、云南省数据发展促进中心、云南省大数据有限公司、浪潮软件股份有限公司。

　　本文件主要起草人：李鑫、林晓晖、刘迎仙、周仕钧、罗俊松、范馨予、周佳、薛辉、周应鹤、徐立、黎慧、杨云江、梅利、赵雅楠、倪祥路、李杰。

　　II

　　T/YNBX 600.3—2026

　　云南省电子证照数据共享技术服务规范

　　第 3 部分：服务接口

　　1 范围

　　本文件规定了云南省电子证照数据共享技术服务的接入要求及调用方式。

　　本文件适用于云南省内使用电子证照数据共享技术服务的各参与方。

　　2 规范性引用文件

　　下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，仅该日期对应的版本适用于本文件;不注日期的引用文件，其最新版本(包括所有的修改单)适用于本文件。

　　GB/T 36901-2018 电子证照 总体技术架构

　　GB/T 36906-2018 电子证照 共享服务接口规范

　　3 术语和定义

　　GB/T 36901-2018、GB/T 36906-2018界定的以及下列术语和定义适用于本文件。

　　3.1

　　电子证照

　　按规范形式表达或承载证照信息的电子文件，包含证照模板、证照数据和签章/签名信息。

　　[来源：GB/T 36901-2018，3.3] 3.2

　　电子证照业务系统

　　使用电子证照替代纸质证照的业务应用系统。

　　4 缩略语

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

　　REST：表述性状态转移(Representational State Transfer)

　　OFD：开放版式文档(Open Fixed-layout Document)

　　JSON：JS 对象简谱(JavaScript Object Notation)

　　SM2：椭圆曲线公钥密码算法(SM2 Elliptic Curve Public Key Cryptographic Algorithm)

　　SM3：SM3 密码哈希算法(SM3 Cryptographic Hash Algorithm)

　　API：应用程序接口(Application Programming Interface)

　　HTTPS：安全的超文本传输协议(Hypertext Transfer Protocol Secure)

　　URL：统一资源定位符/标识(Uniform Resource Locator)

　　5 接入要求

　　1

　　T/YNBX 600.3—2026

　　5.1 接入内容

　　电子证照的服务接入包括但不限于：

　　a) 接入身份认证服务：提供对接入应用和用户身份进行合法性验证等功能;

　　b) 电子证照目录服务：提供电子证照全省目录、地区和部门应开通目录查询功能;

　　c) 电子证照制证服务：提供电子证照制证、签发、更新、废止等功能;

　　d) 电子证照用证服务：提供对电子证照进行查询、调用和有效性、归档等功能。

　　5.2 接入方式

　　电子证照的接入方式包括：

　　a) 接口采用 REST 服务(Web 请求)进行数据交换;

　　b) 接口的请求和返回结果采用 JSON 格式;

　　c) 接口应支持跨系统、跨平台调用;

　　d) 传输的数据应采用加密和防篡改技术保证数据的机密性、完整性、可用性。

　　6 身份认证

　　采用通用API 签名认证方式，请求参数见表 1、表 2，调用示例参照附录 A.1。

　　表 1 认证请求参数

　　参数英文名

　　参数中文名

　　是否必选

　　类型

　　说明

　　appCode

　　应用编码

　　是

　　字符串

　　分配给应用程序的唯一标识appId

　　time

　　时间戳

　　是

　　字符串

　　调用时间精确到毫秒的时间戳，请求时间戳与服务器时间差需在±10 分钟内

　　sign

　　请求签名

　　是

　　字符串

　　对原始请求和时间戳使用国密签名算法计算签名值

　　业务参数

　　是

　　--

　　使用注册应用的平台公钥对原始请求信息进行加密

　　表 2 认证返回结果参数

　　参数英文名

　　参数中文名

　　是否必选

　　类型

　　说明

　　statusCode

　　返回码

　　是

　　整型

　　200：接口调用成功;

　　其它：接口调用失败

　　retCode

　　业 务 处理结果

　　是

　　字符串

　　SUCCESS：接口业务处理成功;

　　FAILED：接口业务处理遇到问题

　　error

　　错 误 信息

　　否

　　JSON 对象

　　接口业务处理遇到的错误信息

　　业务参数

　　否

　　--

　　业务处理返回结果信息

　　7 制证

　　2

　　T/YNBX 600.3—2026

　　7.1 制证流程

　　制证流程如下：

　　a) 制发机构调用接口时，在请求参数中加入应用编码、请求时间戳和请求签名，使用公钥对入参进行加密;

　　b) 接收对接请求后，对请求发起方进行身份认证。认证通过的，触发电子证照系统执行制证操作。认证未通过的，直接向业务系统(制证)返回对应错误代码，同步记录错误日志;

　　c) 电子证照系统制发证照后，经加密处理，返回至业务系统(制证)。

　　7.2 制证接口参数

　　7.2.1 证照新增、变更数据提交

　　证照新增、变更数据提交服 格式、请求参数和返回结果详见表

　　3，调用示例参照附录 B.1。

　　表 接口

　　方法名

　　submitLicenceD

　　请求方式

　　POST

　　请求参数格式

　　application/js

　　请求参数

　　参数名

　　说明

　　type

　　操作类型: new-新增 change-变更

　　CertificateID

　　原系统生成的证照标识

　　autoSeal

　　证 照 附 件 生 成 是 否 自 动 签 章true/false)默认 false

　　oldCertificate

　　ype 为 change 时，传递原证照标识

　　meta

　　Data {}

　　certype

　　证照明细编码

　　certype

　　证照模板名称

　　certificateNumbe r

　　是

　　字符串

　　照面编号

　　issueDeptCode

　　是

　　字符串

　　证照颁发机构代码

　　issueDept

　　是

　　字符串

　　证照颁发机构

　　inputDeptCode

　　是

　　字符串

　　证照录入机构代码

　　certificateAreaC ode

　　certificateAreaN ame

　　是 否

　　字符串

　　字符串

　　区划代码

　　区划名称

　　issueDate

　　是

　　日期

　　颁发日期

　　3

　　T/YNBX 600.3—2026

　　表 3 证照新增、变更数据提交服务接口(续)

　　请求参数

　　参数名

　　必选

　　类型范围

　　说明

　　meta

　　Data {}

　　certificateHolde r

　　是

　　字符串

　　持有者姓名

　　certificateHolde rCode

　　是

　　字符串

　　持有者证件号码

　　certificateHolde rType

　　是

　　字符串

　　持有者证件类型

　　certificateHolde rCategory

　　是

　　字符串

　　持有者类型

　　validityStart

　　是

　　日期

　　有效期开始

　　validityEnd

　　是

　　日期

　　有效期截止

　　certificateLevel

　　否

　　字符串

　　证照等级

　　phoneNumber

　　否

　　字符串

　　电话号码

　　remark

　　否

　　字符串

　　备注

　　surf

　　aceD

　　ata{ }

　　照面项英文名称

　　是

　　--

　　照面项取值

　　attachment

　　否

　　字符串

　　BASE64 编码文件内容

　　waterMark

　　否

　　字符串

　　系统合成的证照文件上的水印内容

　　operatorId

　　否

　　字符串

　　操作用户的 id，如有，建议传递

　　flowCode

　　否

　　字符串

　　业务号

　　返回结果

　　参数名

　　类型范围

　　说明

　　id

　　字符串

　　证照标识

　　licenseNumber

　　字符串

　　照面编号

　　fileState

　　字符串

　　附件状态

　　7.2.2 证照注销服务

　　证照注销服务接口方法名、请求方式、请求参数格式、请求参数和返回结果详见表4，调用示例参照附录 B.2。

　　表 4 证照注销服务接口

　　方法名

　　cancelUseLicence

　　请求方式

　　POST

　　请求参数格式

　　multipart/form-data 或 application/x-www-form-urlencoded

　　4

　　T/YNBX 600.3—2026

　　表 4 证照注销服务接口(续)

　　请求参数

　　参数名