团体标准-跨证书认证机构多证照身份认证服务应用接口标准

前 言

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

请注意本标准的某些内容可能涉及专利。本标准的发布机构不承担识别专利的责任。本标准由 xxx 提出并归口。

本标准起草单位：xxx、xxx、xxxx。本标准主要起草人：xxx、xxx。

1 范围

本标准规定了跨CA机构多证照身份认证应用接口规范的通讯协议和应用接口，是为了规范满足国家标准发布的数字证书、电子证照（如：医师执业证书）等多种方式的身份认证服务。

本标准适用于应用系统接入身份认证服务，通过API接口调用身份认证服务、电子签章等基础服务。

注：本标准规定的电子签名采用代理签名模式。

2 规范性引用文件

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

GB/T 33560-2017 信息安全技术 密码应用标识规范

GB/T 25064-2010 信息安全技术 公钥基础设施 电子签名格式规范

GB/T 19713-2005 信息技术 安全技术 公钥基础设施 在线证书状态协议

GB/T 19714-2005 信息技术 安全技术 公钥基础设施 证书管理协议

GB/T 25056-2018 信息安全技术证书认证系统密码及其相关安全技术规范

GB/T 20520-2006 信息安全技术 公钥基础设施 时间戳规范

GB/T 35285-2017 信息安全技术 公钥基础设施 基于数字证书的可靠电子签名生成及验证技术要求

GB/T 20518-2018 信息安全技术 公钥基础设施 数字证书格式

GB/T 32905-2016 信息安全技术 SM3密码杂凑算法

GB/T 35275-2017 信息安全技术 SM2密码算法加密签名消息语法规范

GB/T 35276-2017 信息安全技术 SM2密码算法使用规范

GB/T 38540-2020 信息安全技术 安全电子签章密码技术规范

GM/T 0109-2021 基于云计算的电子签名服务技术要求

GM/T 0120-2022 基于云计算的电子签名服务技术实施指南

GB/Z 21716.1-2008 健康信息学 公钥基础设施（PKI） 第1部分：数字证书服务综述

GB/Z 21716.2-2008 健康信息学 公钥基础设施（PKI） 第2部分：证书轮廓

GB/Z 21716.3-2008 健康信息学 公钥基础设施（PKI） 第3部分：认证机构的策略管理

GM/Z0001-2013 密码术语

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

GB/T 36902-2018 电子证照 目录信息规范

GB/T 36903-2018 电子证照 元数据规范

GB/T 36904-2018 电子证照 标识规范

GB/T 36905-2018 电子证照 文件技术要求

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

PKCS #7 密码消息语法(Cryptographic message syntax)

PKCS #1 RSA Cryptography Specifications

3 术语和定义

下列术语和定义适用于本标准。

3.1数字证书 digital certificate

也称公钥证书，由证书认证机构(CA）签名的包含公开密钥拥有者信息、公开密钥、签发者信息、有效期以及扩展信息的一种数据结构。按类别可分为个人证书、机构证书和设备证书，按用途可分为签名证书和加密证书。

[来源：GB/T 25056—2018]

3.2证书认证机构certification authority (CA）

对数字证书进行全生命周期管理的实体。也称为电子认证服务机构。

[来源：GB/T 25056—2018]

3.3数字签名digital signature

签名者使用私钥对待签名数据的杂凑值做密码运算得到的结果,该结果只能用签名者的公钥进行验证,用于确认待签名数据的完整性、签名者身份的真实性和签名行为的抗抵赖性。

[来源：GM/Z 0001-2013]

3.4证书验证certificate validation

按照验证策略确认证书有效性和真实性的过程。

[来源：GM/Z 0001-2013]

3.5证书撤销列表certificate revocation list (CRL)

由证书认证机构（CA）签发并发布的被撤销证书的列表。

[来源：GM/Z 0001-2013]

3.6时间戳 time stamp(TS)

对时间和其它待签名数据进行签名得到的数据，用于表明数据的时间属性。

[来源：GM/Z 0001-2013]

3.7电子签章digitally seal

使用电子印章签署电子文件的过程。

[来源：GM/Z 0001-2013]

3.8电子印章digital stamp

一种由制作者签名的包括持有者信息和图形化内容的数据，可用于签署电子文件。

[来源：GM/Z 0001-2013]

3.9证照certificate

由机关、团体、企事业单位颁发的、能够证明资格或权利等的凭证类文件。

注：证照包括证件和执照等。

[来源：GB/T 36901-2018]

3.10电子证照electronic certificate

由计算机等电子设备形成﹑传输和存储的证照数据文件。

[来源：GB/T 36901-2018]

3.11电子证照文件electronic certificate file

以版式文档表示的电子证照，该文件既包含照面固定版式效果，又包含证照元数据及标识，并应用密码技术保障这些内容的真实性和完整性。

[来源：GB/T 36901-2018]

3.12电子证照有效性electronic certificate validity

电子证照的凭证效力被其颁发机构继续认可的性质。

[来源：GB/T 36906-2018]

3.13电子证照文件完整性electronic certificate file integrity

电子证照文件的内容，结构和背景信息齐全且没有破坏、变异或丢失的性质。

[来源：GB/T 36906-2018]

3.14

电子证照文件真实性electronic certificate file authenticity

电子证照文件中的内容、结构和背景信息与形成时的原始状态相一致的性质。

[来源：GB/T 36906-2018]

3.15带密钥的杂凑算法 keyed-hash message authentication code (HMAC)

一种密码杂凑算法，密钥作为其输入参数参与运算。

[来源：GM/Z 0001-2013]

3.16代理签名 delegated signature mechanism

签名方将密钥托管在云服务，授权云服务完成电子签名的机制。

[来源：GM/T 0120-2022]

4 缩略语

API Application Program Interface 应用程序接口,简称应用接口

CA Certification Authority 证书认证机构

HMAC Keyed-hash message authentication code 一种密码杂凑算法。

JSON JavaScript 0bject Notation JS对象标记

HTTP Hyper Text Transfer Protocol 超文本传输协议

HTTPS Hyper Text Transfcr Protocol over SecurcSocket Layer 安全的HTTP协议

PIN Personal Identification Number 个人标识码

P7 PKCS#7 Public Key Cryptography Standards#7

P1 PKCS#1 Public Key Cryptography Standards#1

5 身份认证服务应用接口调用说明

5.1 接口调用说明

图1身份认证服务接口说明

身份认证服务为机构的应用系统提供API接口服务，其中包括身份认证服务、电子签章服务。

身份认证服务为机构的应用系统提供基于数字证书的电子签名、签名验证、时间戳、及电子证照等基础服务。

电子签章服务为机构的应用系统提供基于数字证书的电子签章服务，以确保电子文档来源真实性以及文档的完整性，防止对文档未经授权的篡改，并确保签章行为的不可否认性。

机构的应用系统在接入之前，需要提出接入申请，获取应用的app_id和app_secret，才能使用身份认证服务。

5.2 参数约束定义

6 通讯协议和数据结构

6.1 通讯协议

身份认证服务和应用系统基于HTTPS协议，报文格式定义如下：

请求数据封装格式：application/json

返回数据封装格式：application/json

请求和响应参数组成结构说明如下：

接口请求和响应的均为json格式数据报文，数据报文由公共参数和业务参数两部分构成，请求报文需要由应用系统使用HMAC签名算法进行签名计算，支持的签名算法为HMAC-SM3。

6.2 请求方法和URL规则

支持HTTPS GET POST方法。

——使用GET方法时，输入参数附加在请求的URL上，输出参数为JSON格式。

示例如下：

https://{ip:port}/open/{signature}?{paramkey}={paramValue}

——使用POST方法时，输入和输出参数均采用JSON格式。

示例如下：

https://{ip:port}/open/{signature}

注：*{斜体}*为可变内容域，是身份认证服务网络地址，下同。

6.3 授权类别

——当前支持的授权类别为trusted，必须经过验证签名。

6.4 认证信息

应用系统在与身份认证服务通讯时，应提供认证信息，用于鉴别其身份。可以通过验证签名的方式鉴别各个接入的应用系统的身份。

——身份认证服务向申请接入的应用系统分配的唯一app_id和app_secret。

——通过接口传输数据时，调用方应通过HMAC-SM3算法对请求数据进行加签计算。

——开放接口采用https协议。

公共参数放入请求头中进行传输，请求的Header中包含认证信息如下：

公共参数放入请求头中进行传输，请求的Header中包含认证信息如下：

签名值生成规则:

——json提交

a）json字符串后面拼接随机数(nonce对应值，随机数在前)和时间戳（timestamp对应值）得到字符串。

b）将a得到的字符串进行HmacSM3运算，计算后将结果转换为16进制(小写)，即为签名信息，放入请求头(signature)中。

6.5 状态信息

身份认证服务API返回状态信息，状态信息包含字符形式的状态码和状态描述。状态码见附录A的规定。

6.6 回调数据

因部分操作是异步操作，当异步操作完成后，身份认证服务向应用系统的回调地址发送回调数据。回调数据格式：

回调数据样例：

 {  "result_code":"0", 
    "result_msg":"请求成功", 
    "success":true, 
    "body":{} 
 }

7 身份认证服务接口

7.1 接口列表

表格1 身份认证服务接口列表

7.2 数字证书签名

URL： https://{ip:port}/open/signature/sign
调用方法： POST
功能描述： 采用已经申请有效数字证书对签名原文进行数字签名。
 

返回内容示例：

{	"result_code":"0", 
	"result_msg":"请求成功",  
	"success":true,  
	"body":{ "signP7":" MIIE+g1JKoZIhvcNAQcCoIIE6zCCBO.....UXtTTr4dRMi7iNG2W5ZcU1BysPPM8fpwPFyfEZV2wwIhAMB7vAK1n1xIl2+LRJS1aicmGqBMRZFSOc61ZkKFRRqS ", 
		 "signP1":"QcCoIIE6zCCBO.....UXtTTr4dRW5ZcU1BysPPM8AK1n1xIl2RqS ",  
		 "certBase64":" MIIDjDCCAzCgAwIBAgIUfT7uMyQfR…..mBggrBgEFBQcCAEbHkaZ/UxN1dMAXGeda4NWJ0pqR0OVAD8NX+ii+MK4 ",  
		 "signatureAlgID":"SM2"   
	} 
} 

7.3 数字证书查询

URL： https://{ip:port}/open/digitalCert/list
调用方法： POST
功能描述： 查询主体的数字证书信息。
 

返回内容示例：

{  "result_code":"0",  
   "result_msg":"请求成功",  
   "success":true,  
   "body":[{  "digitalCertId":" 123",  
	      "certBase64":" MIIDjDCCAzCgAwIBAgIUfT7uMyQfR…..mBggrBgEFBQcCAEbHkaZ/UxN1dMAXGeda4NWJ0pqR0OVAD8NX+ii+MK4 ",  
	      "digitalCertCN":"mnn公司" ， 
	      "digitalCertSN ":" 1ddfdfasdlfksjdflj3",  
	      "notAfter":"2023-01-05 13:20:21",  
	      "notBefore ":"2022-01-06 13:20:21"  
	   }] 
}

7.4 数字签名验证

URL： https://{ip:port}/open/signature/verify
调用方法： POST
功能描述： 用户进行数字签名后,调用此接口进行签名有效性验证。
 

{
  "result_code": "200",
  "result_msg": "验签成功",
  "success": true,
  "body": {
    "isVerify": true,
    "certInfo": {
      "certBase64": "base64",
      "signatureAlgID": "3333",
      "certIssuer": "四川ca",
      "certNo": "3333",
      "certNotAfter": "2023-10-12 00:00:00",
      "certNotBefore": "2022-10-12 00:00:00",
      "certCN": "张三"
    },
    "signInfo": {
      "timeData": "dfsdsldhfsdj",
      "signTime": "2020-12-12 00:00:00"
    }
  }
}

7.5 生成时间戳

URL： https://{ip:port}/open/timestamp/sign
调用方法： POST
功能描述： 按照国家标准生成时间戳。
 

返回内容示例：

{	"result_code":"0",
	"result_msg":"请求成功",
	"success":true,
	"body":{
		"timeData":" MIIE+g1JKoZIhvcNAQcCoIIE6zCCBO.....UXtTTr4dRMi7iNG2W5ZcU1BysPPM8fpwPFyfEZV2wwIhAMB7vAK1n1xIl2+LRJS1aicmGqBMRZFSOc61ZkKFRRqS"
	}
}

7.6 验证时间戳有效性

URL： https://{ip:port}/open/timestamp/verify
调用方法： POST
功能描述： 验证时间戳是否有效。
 

返回内容示例：

{
	"result_code":"0",
	"result_msg":"请求成功",
	"success":true,
	"body":{
		"time":"2023-01-05 13:20:21"
	}
}

7.7 二维码生成

URL： https://{ip:port}/open/qrcode/applyQrCode
调用方法： POST
功能描述： 通过二维码进行登录或签名时，通过调用此接口获取对应的二维码。
 

返回内容示例：

{  
	"result_code":"0",  
	"result_msg":"请求成功",  
	"success":true,  
	"body":{ "qrCode":"DEVDFALDKFKALSDJFJD---",  
		 "qrCodeUid":"123343546675"  
	} 
}

7.8 二维码状态查询

URL： https://{ip:port}/open/qrcode/qrCodeStatusQuery
调用方法： POST
功能描述： 用于二维码状态查询。
 

返回内容示例：

{  "result_code":"0",  
   "result_msg":"请求成功",  
   "success":true,  
   "body":{ "status":" SCANING "  
   } 
} 

7.9 二维码回调

URL： 由业务系统提供的回调地址。
调用方法： https://{ip:port}/{业务系统提供}
功能描述： 用于二维码扫描签名或登录完成后的应用系统回调，应用系统获取签名值和原文后进行签名验证。
 

7.10 解析二维码信息

URL： https://{ip:port}/open/qrcode/qrCodAnalysis
调用方法： POST
功能描述： 用于二维码信息解析。
 

返回内容示例：

 {  "result_code":"0",  
    "result_msg":"请求成功",  
    "success":true,  
    "body":{  "busiType":"SIGN"， 
	      " toSign ":" 签名原文"
    } 
}

7.11 电子证照检索（医生和护士）

URL： https://{ip:port}/open/elecCert/personRetrieval
调用方法： POST
功能描述： 通过电子证照标识，获取证照信息和证照二维码。
 

返回内容示例：

{
	"result_code":"0",
	"result_msg":"请求成功",
	"success":true,
	"body":[
		{        "elecCertId": "1234567890",
			 "elecCertName":"医师执业证",
			 "elecCertHolder": "张医生",
			 "elecCertHolderCode": "522228199612100611",
			 "techPost"："",
			 "elecCertType": "DOCTOR",
			 "elecCertTypeName":"医师执业证",
			  "sex":"男",
			 "brithday":"1999-10-01",
			 "elecCertNumber": "1262235241",
			 "elecCpetCode":"200151110130203197607131511",
			 "practiceScope":"外科专业",
			 "practiceLevel":"执业医师",
			 "practiceClass":"临床",
			 "practiceAreaName":"青羊区",
			 "practiceOrgId":"88EFE14F-119A-406E-8967-3D33E7D2B93E",
			 "issueDept": "成都市青羊区卫生和计划生育局",
			 "issueDeptCode": "370100004188602",
			 "issueDate": "2019-10-14",
			 "validityStart": "2019-10-14",
			 "validityEnd": "2019-10-14",
			 "state": "1"
		}	
		]
}

7.12 电子证照检索（机构）

URL： https://{ip:port}/open/elecCert/orgRetrieval
调用方法： POST
功能描述： 通过单位唯一标识获取单位证照信息。
 

返回内容示例：

{
	"result_code":"0",
	"result_msg":"请求成功",
	"success":true,
	"body":[{         "elecCertId": "1234567890",
			  "elecCertName":"xxx医疗机构执业许可证",
			  "elecCertHolder": "xx医疗机构",
			  "elecCertHolderCode": "12323232",
			  "elecCertNumber": "1262235241",
			  "specialtiesName":"内科、外科",
			  "areaName":"锦江区",
			  "legalPerson":"张三",
			  "holderCardNumber":"23434324334343343",
			  "adress":"四川省成都市锦江区xxx路xxx号",
			  "chargeRepresentative":"xxx",
			  "natureBusiness":"",
			  "setFormedName":"xxx",
			  "telNum":"028-xxx",
			  "category":"",
			  "secondName":"",
			  "level":"三甲",
			  "rankName":"",
			  "adminOrgName":"",
			  "issueDept": "成都市青羊区卫生和计划生育局",
			  "issueDeptCode": "370100004188602",
			  "issueDate": "2019-10-14",
			  "validityStart": "2019-10-14",
			  "validityEnd": "2019-10-14",
			  "state": "1"
		}]
}

7.13 电子证照查证

URL： https://{ip:port}/open/elecCert/query
调用方法： POST
功能描述： 通过电子证照标识，获取证照pdf文件。
 

返回内容示例：

{
	"result_code":"0",
	"result_msg":"请求成功",
	"success":true,
	"body":{
		 " elecPdfBase64": "DFDFSDDFS***="
	}	
}

7.14 电子证照真伪验证

URL： https://{ip:port}/open/elecCert/verifySeal
调用方法： POST
功能描述： 电子证照签章验证，验证章的有效性。
 

返回内容示例：

{
	"result_code":"0",
	"result_msg":"请求成功",
	"success":true,
	"body":{
	     " verifyResult ":"true",
		 "fileName ":"ddd.pdf",
		 "verifyList":[{
			 "signIndex":1,
			 "signStd":"ds.PKCS7",
			 "verify":"unknown",
			 "errorCode":"c803302",
			 "errorMsg":"该数字签名为rsa签名",
			 "certInfo":{
				   "certBase64":"base64",
				   "signatureAlgID":"3333",
				   "certIssuer":"四川ca", 
				   "certNo":"3333",
				   "certNotAfter":"2023-10-12 00:00:00",
				   " certNotBefore ":"2022-10-12 00:00:00",",
				   "certCN":"张三",
			 },
			 "signInfo":{
				   "timeData":"dfsdsldhfsdj",
				    "signTime":"2020-12-12 00:00:00"
			 }
	       
		 }]
	}
}

7.15 电子证照类型列表

URL： https://{ip:port}/open/ elecCert/queryTypeList
调用方法： POST
功能描述： 获取电子证照类型列表。
 

返回内容示例：

{
	"result_code":"0",
	"result_msg":"请求成功",
	"success":true,
	"body":[{
		    "elecCertType": "NURSE",
		    " elecCertTypeName ": "护士执业证"
	}]	  
}

7.16 待签署数据推送

URL： https://{ip:port}/open/sign/pushData
调用方法： POST
功能描述： 机构的应用系统可以将数据同步到身份认证服务，在移动设备上完成签署（移动设备上的移动APP、小程序为身份认证服务提供）。
 

输入参数示例：

{
	"patientInfo":{
		"name":"张三",
		"age":"100",
		"sex":"1",
		"no":"patient_no_001",
		"personCard":"333---"
	},
	"signType":"1",
	"isSignOrder":"0",
	"doctorSignInfo":[{
		"personCard":"333--",
		"signOrder":"1"
	}],
	"dataCatalogCode":" recipe",
	"datasource":{
		"dataName":"处方",
		"data":[
			{
				"key":"症状",
				"value":"发热"
			},
			{
				"key":"体温",
				"value":"39度"
			}
		]
	}
}

返回内容示例：

{  "result_code":"0",
   "result_msg":"请求成功",
   "success":true,
   "body":{
	   "dataId":"12344",
	   "qrCode ":"base64"
   }
}

7.17 待签署Pdf文件推送

URL： https://{ip:port}/open/sign/pushPdf
调用方法： POST
功能描述： 机构的应用系统pdf版式文件同步到身份认证服务，签署人在移动设备上完成签署（移动设备上的移动APP、小程序为身份认证服务提供）。
 

输入参数示例：

{
	"patientInfo":{
		"name":"张三",
		"age":"100",
		"sex":"1",
		"no":"patient_no_001",
		"personCard":"333---"
	},
	"signType":"1",
	"isSignOrder":"0",
	"doctorSignInfo":[
	{
	    "personCard":"333--",
	    "signOrder":"1"
	  }
	],
	"patientSignInfo":[
		{
		    "keyword":"患者签名",
		    "keywordIndex":1,
		    "x":40,
		    "y":0,
		    "fillStyle":"1"
		}
	],
	"pdfInfo":{
	    "fileName":"afc.pdf",
	    "pdfBase64":"base64"
	}
}

返回内容示例：

{
	"result_code":"0",
	"result_msg":"请求成功",
	"success":true,
	"body":{
		"dataId":"12344 ",
		"qrCode":"base64"
	}
}

7.18 认证服务签署状态查询接口

URL： https://{ip:port}/open/sign/querySignStatus
调用方法： POST
功能描述： 业务系统把数据/文件推送到身份认证服务，在移动设备上签署时的状态查询（移动设备上的移动APP、小程序为身份认证服务提供）, 返回签署信息。
 

返回内容示例：

{
  "id": "1303172585906810882",
  "signStatus": 0,
  "docContentBase64": "…",
  "doctorSignInfo": [
    {
      "cardNumber": "007",
      "name": "张三医生",
      "seal": "...",
      "signTime": 1597225333000,
      "timeData": "MIIE+gYJKoZIhvcNAQcCoIIE6zCCBO.....UXtTTr4dRMi7iNG2W5ZcUYBysPPM8fpwPFyfEZV2wwIhAMB7vAK1n1xIl2+LRJSYaicmGqBMRZFSOc6YZkKFRRqS",
      "siend": true,
      "signChannel": "APP",
      "signature": "MIIFBgYJKoZIhvc……8BC75zXwc0PZGLNIsrUtj2tm2"
    }
  ],
  "patientSignInfo": {
    "no": "123456",
    "name": "李四患者",
    "signerName": "李四亲属",
    "seal": "...",
    "signature": "MIIFBgYJKoZIhvc……8BC75zXwc0PZGLNIsrUtj2tm2",
    "signTime": 1597225833000,
    "timeData": "MIIE+gYJKoZIhvcNAQcCoIIE6zCCBO.....UXtTTr4dRMi7iNG2W5ZcUYBysPPM8fpwPFyfEZV2wwIhAMB7vAK1n1xIl2+LRJSYaicmGqBMRZFSOc6YZkKFRRqS",
    "signed": true,
    "signChannel": "WX",
    "holders": {
      "双方关系": "朋友",
      "联系电话": "19090909090"
    }
  }
}

7.19 认证服务签署状态通知

URL： {接口由业务系统提供}/pushcallback
调用方法： POST
**功能描述：**业务系统把数据/文件推送到身份认证服务，用户在移动设备上签署/废弃数据后, 身份认证服务通过此接口通知第三方系统，返回数据格式遵循“6.6 回调数据”格式标准.
 

输入参数示例：

{
  "id": "1303172585906810882",
  "signStatus": 0,
  "docContentBase64": "...",
  "doctorSignInfo": [
    {
      "cardNumber": "007",
      "name": "张三医生",
      "seal": "...",
      "signTime": 1597225333000,
      "timeData": "MIIE+gYJKoZIhvcNAQcCoIIE6zCCBO.....UXtTTr4dRMi7iNG2W5ZcUYBysPPM8fpwPFyfEZV2wwIhAMB7vAK1n1xIl2+LRJSYaicmGqBMRZFSOc6YZkKFRRqS",
      "siend": true,
      "signChannel": "APP",
      "signature": "MIIFBgYJKoZIhvc……8BC75zXwc0PZGLNIsrUtj2tm2"
    }
  ],
  "patientSignInfo": {
    "no": "123456",
    "name": "李四患者",
    "signerName": "李四亲属",
    "seal": "...",
    "signature": "MIIFBgYJKoZIhvc……8BC75zXwc0PZGLNIsrUtj2tm2",
    "signTime": 1597225833000,
    "timeData": "MIIE+gYJKoZIhvcNAQcCoIIE6zCCBO.....UXtTTr4dRMi7iNG2W5ZcUYBysPPM8fpwPFyfEZV2wwIhAMB7vAK1n1xIl2+LRJSYaicmGqBMRZFSOc6YZkKFRRqS",
    "signed": true,
    "signChannel": "WX",
    "saveType": 2,
    "holders": {
      "双方关系": "朋友",
      "联系电话": "19090909090"
    }
  }
}

7.20 获取数据签署H5链接地址

URL： https://{ip:port}/open/signature/h5Sign
调用方法： POST
功能描述： 应用系统调用此接口,返回一个签署界面url链接地址，用户在url对应界面上对数据进行签署。
 

返回内容示例：

{
     "result_code":"0",
     "result_msg":"请求成功",
     "success":true,
     "body":{
       " htmlUrl ": "https://www.{....}.com",

     }
}

7.21 获取pdf签署H5链接地址

URL： https://{ip:port}/open/signature/h5SignPdf

调用方法： POST
功能描述： 应用系统调用此接口,返回一个签署界面url，用户在url对应界面上对PDF文件进行签署。
 

关键字输入参数示例：

{
    "requestId": "requestId",
    "userType": 1,
    "personCard": "",
    "orgCode": "",
    "sealId": "1673983799422935041",
    "digitalCertId": "",
    "orgName": "测试医疗机构",
    "sealType": "关键字",
    "isQf": true,
    "qfPossition": 0.8,
    "sealInfo": [
        {
            "keyword": "医生签名",
            "pageConfigList": [
                {
                    "pageNo": 1,
                    "keyWordIndex": 1
                }
            ]
        },
        {
            "keyword": "患者意见",
            "pageConfigList": [
                {
                    "pageNo": 1,
                    "keyWordIndex": 1
                }
            ]
        }
    ],
    "file": ""
}

坐标输入参数示例：

{
    "requestId": "requestId",
    "userType": 1,
    "personCard": "",
    "orgCode": "",
    "sealId": "1673983799422935041",
    "digitalCertId": "",
    "pin": "123456",
    "orgName": "测试医疗机构",
    "signType": "坐标",
    "entityName": "程",
    "isqf": true,
    "qfPossition": 0.5,
    "sealInfo": [
        {
            "pageNo": 1,
            "x": 0.4,
            "y": 0.1
        }
    ],
    "file": "2Jq/F3CpS"
}

返回内容示例：

{
     "result_code":"0",
     "result_msg":"请求成功",
     "success":true,
     "body":{
       "htmlUrl ": "https://www.{....}.com",
     }
}

7.22 H5或接口签署信息查询接口

URL： https://{ip:port}/open/sign/queryApiSignInfo
调用方法： POST
功能描述： 业务系统通过“7.21 获取pdf签署H5链接地址、7.20 获取数据签署H5链接地址、7.2数字证书签名、 8.3电子签章”进行签署时，签署信息查询, 返回签署信息。
 

返回内容示例：

{
     "result_code":"0",
     "result_msg":"请求成功",
     "success":true,
     "body":{
              "signStatus": 0,
              "certInfo":{
                   "certBase64":"base64",
                   "signatureAlgID":"3333",
                   "certIssuer":"四川ca", 
                   "certNo":"3333",
                   "certNotAfter":"2023-10-12 00:00:00",
                   " certNotBefore ":"2022-10-12 00:00:00",
                   "certCN":"张三",
              },
              "signInfo":{
                   "timeData":"dfsdsldhfsdj",
                    "signTime":"2020-12-12 00:00:00"，
                    "signP7":"dddfdf",
                    "seal":"base64"，
                    "docContentBase64": "base64",
                    "toSign": "签名原文"
               } 
        }
}

7.23 H5签署状态通知

URL： {接口由业务系统提供}/pushcallback
调用方法： POST
功能描述： h5签署数据或pdf时，返回的状态通知，数据格式遵循“6.6 回调数据”数据标准。
 

输入参数示例：

{
  "docContentBase64": "base64",
  "signStatus": 0,
  "signInfo": {
    "timeData": "dfsdsldhfsdj",
    "signTime": "2020-12-12 00:00:00",
    "signP7": "dddfdf",
    "seal": "base64",
    "docContentBase64": "base64",
    "toSign": "签名原文"
  },
  "certInfo": {
    "certBase64": "base64",
    "signatureAlgID": "3333",
    "certIssuer": "四川ca",
    "certNo": "3333",
    "certNotAfter": "2023-10-12 00:00:00",
    "certNotBefore": "2022-10-12 00:00:00",
    "certCN": "张三"
  }
}

7.24 免密签署状态查询

URL： https://{ip:port}/open/digitalCert/pinSaveStatus
调用方法： POST
功能描述： 查询免密签署是否开启，用户免密操作，如果开启，在“7.2 数字证书签名”和“8.3 电子签章”接口则可以不传入pin码。
 

返回内容示例：

{
     "result_code":"200",
     "result_msg":"成功",
     "success":true,
     "body":{ pinStatus：1 }
}

8 电子签章服务接口

8.1 接口列表

表格2 电子签章服务接口列表

8.2 电子印章查询

URL： https://{ip:port}/open/signature/sealQuerysealQue
调用方法： POST
功能描述： 查询单位或个人电子印章。
 

返回内容示例：

{
     "result_code":"0",
     "result_msg":"请求成功",
     "success":true,
     "body":{[
            "sealId":"12343243",
            "sealData":"DEF****==",
            "makeEsealTime":"2022-10-20 12:00:00" ，
           " defaultSeal ":"1"
     ]}
}

8.3 电子签章

URL： https://{ip:port}/open/signature/signPdf

调用方法： POST
功能描述： 应用系统调用此签章接口完成PDF文件的文件签署。
 

关键字输入参数示例：

{
	"userType": 1,
	"personCard": "",
	"orgCode": "",
	"sealId": "1673983799422935041",
	"digitalCertId": "",
	"pin": "123456",
	"orgName": "测试医疗机构",
	"signType": "关键字",
	"entityName": "程",
	"isqf": true,
	"qfPossition": 0.8,
	"sealInfo": [
		{
		"keyword": "医生签名",
		"pageConfigList": [
			{
			"pageNo": 1,
			"keyWordIndex": 1
			}
		]
		},
		{
			"keyword": "患者意见",
			"pageConfigList": [
			{
				"pageNo": 1,
				"keyWordIndex": 1
			}
			]
		}
	],
	"file": ""
}

坐标输入参数示例：

{
	"requestId": "requestId",
	"userType": 1,
	"personCard": "",
	"orgCode": "",
	"sealId": "1673983799422935041",
	"digitalCertId": "",
	"pin": "123456",
	"orgName": "测试医疗机构",
	"signType": "坐标",
	"entityName": "程",
	"isqf": true,
	"qfPossition": 0.5,
	"sealInfo": [
		{
			"pageNo": 1,
			"x": 0.4,
			"y": 0.1
		}
	],
	"file": "2Jq/F3CpS"
}

返回内容示例：

{
     "result_code":"0",
     "result_msg":"请求成功",
     "success":true,
     "body":{
                "sealId ":"12344 ",
                "requestId":"12345",
                "signData":"DFDF***===",
                "sealTime":"2022-12-09 10:00:00"   ，
                "timeData":"MIIE+gYJKoZIhvcNAQcCoIIE6zCCBO.....UXtTTr4dRMi7iNG2W5ZcUYBysPPM8fpwPFyfEZV2wwIhAMB7vAK1n1xIl2+LRJSYaicmGqBMRZFSOc6YZkKFRRqS",
       
     }
}

8.4 电子签章pdf验证接口

URL： https://{ip:port}/open/signature/verifyPdf
调用方法： POST
功能描述： 电子签章pdf验证，验证pdf签章的有效性，并获取签章签署信息。
 

返回内容示例：

 {
  "result_code": "0",
  "result_msg": "请求成功",
  "success": true,
  "body": {
    "verifyResult": "true",
    "fileName": "ddd.pdf",
    "verifyList": [
      {
        "signIndex": 1,
        "signStd": "ds.PKCS7",
        "verify": "unknown",
        "errorCode": "c803302",
        "errorMsg": "该数字签名为rsa签名",
        "certInfo": {
          "certBase64": "base64",
          "signatureAlgID": "3333",
          "certIssuer": "四川ca",
          "certNo": "3333",
          "certNotAfter": "2023-10-12 00:00:00",
          "certNotBefore": "2022-10-12 00:00:00",
          "certCN": "张三"
        },
        "signInfo": {
          "timeData": "dfsdsldhfsdj",
          "signTime": "2020-12-12 00:00:00"
        }
      }
    ]
  }
}

附录A

表格A.1 接口返回状态码定义

表格A.2签署数据种类编码/签署文件种类编码