文档
测试

生成证书(虚拟手机号)

POST
/ecs/account/applyCertString.jspa

描述

(1) 一个证件ID只能申请一次证书,反复申请会失败报错,证书有效期为一年 (2)接口支持个人和企业申请证书 (3)接口返回userNum字段,第三方对接平台需要做好用户对应关系,所有涉及到传==mobilePhone==字段的接口,第三方都需要传==userNum==的值代替 ==适合场景介绍:== 1.如果您应用体系中不存在用户手机号,那么您业务系统可以生成“虚拟手机号”,这样为用户生成证书 2.如果您应用体系中一个手机号对应多个身份信息(==type、cardType、idCardNum== 联合决定一个身份),那么您可以使用这个接口为用户生成整数,这种情况下一个手机号可以为多个 不同身份申请证书

请求参数

参数名
类型
描述
必填
info
JSON
申请者相关信息,数据json格式
必填
timestamp
string
示例:2011-11-28 17:12:50,与服务端时间误差允许为10分钟
必填
appKey
string
示例:平台分配给应用的AppKey、Secret
必填
v
string
示例:1.0
必填
nonce
string
示例:6位数字随机数
必填
signature
string
示例:API入参签名结果
必填
isSign
boolean
是否使用“姓名”生成一个默认签名,如果采用后面的H5签署,建议该字段设置为true,默认为false
可选

请求json示例

```language { "type":"1", //类型 1:个人 、2:企业 "cardType":"0", // 证件类型 0:身份证 1:军官证 ,2:护照、 3:驾驶证、4:工商登记证、5:税务登记证、 6:组织机构代码、7:其他证件,8:统一社会信用代码 "idCardNum":"", // 证件号码 "name":"", //企业或者个人真实名称 "mobilePhone":"" //接口返回userNum字段,第三方对接平台需要做好用户对应关系,所有涉及到传手机号的接口,第三方都需要传该值 } ```

响应参数

参数名
类型
描述
必填
code
string
响应状态码( 0:成功 其他:失败)
必填
message
string
状态描述
必填
data
JSON
数据集
必填
issuer
String
颁发者
必填
serialNumber
String
证书序列号
必填
certNotBefore
String
开始日期
必填
certNotAfter
String
结束日期
必填
userName
String
用户名称
必填
userNum
String
用户编号
必填

响应示例

```language { "meta":{ "code":"0", "message":"操作成功" } "data": { "issuer": "北京易云章科技有限公司", //颁发者 "serialNumber": "xxxx", //序列号 "certNotBefore": "2016-09-28", //开始日期 "certNotAfter": "2017-09-28", //结束日期 "userName":"xxx",//用户名 "userNum":"xxx" //用户编号 } } ```