数据签发起说明
接口说明
[!NOTE]
针对一些特殊场景签约服务,君子签提供数据签发起服务,1、需要先把原始文件的sha512值计算出来
2、接口对签署人为个人时,不会校验姓名+身份证号的真实性,需要开发者确保真实性;君子签可单独提供个人身份证二要素的校验接口,需要联系商务充值后才能使用。
3、接口中签署人信息(证件号)不能重复,最大签署方30个。
4、该调用接口成功后返回presId(备案号)和seqNo(数据签编号),开发者需要保存返回信息,以便后续接口调用。
http请求方式
[!NOTE]
POST multipart/form-data
http请求地址
[!NOTE]
$SERVICE_URL/v2/sign/byteSign #其中$SERVICE_URL为生产或测试的地址
http请求参数
参数 | 类型 | 是否必填 | 默认值 | 说明 |
---|---|---|---|---|
hash | string | * | 对原始数据进行sha512运算得到的hash | |
signatories | JSONArray | * | 签约方,参考后面签约方说明 |
signatories字段说明
[!NOTE]
signatories是合同的签署方信息,为JSONArray结构,即JSONObject数组,且签约人不能存在相同的证件号。签署人参数说明如下:
参数 | 类型 | 是否必填 | 默认值 | 说明 |
---|---|---|---|---|
fullName | string | * | 签约方名称,不超过50个字符 | |
identityType | int | * | 身份类型:1身份证,2护照,3台胞证,4港澳居民来往内地通行证,11营业执照,12统一社会信用代码 | |
identityCard | string | * | 个人传身份证号,企业传营业执照号/统一社会信用代码号 | |
string | ? | 证件类型identityType=11/12时必传 |
http返回参数
[!NOTE]
返回response为application/json的数据,其字段说明如下
参数 | 类型 | 是否必返回 | 说明 |
---|---|---|---|
success | bool | * | 成功true;异常false |
msg | string | ? | 异常时,返回异常原因 |
resultCode | string | ? | 异常时返回 |
data | object | ? | 返回业务内容 |
data参数说明
参数 | 类型 | 是否必返回 | 说明 |
---|---|---|---|
presId | string | * | 备案号 |
seqNo | string | * | 数据签编号 |
[!NOTE]
返回结果,参考:
//错误响应
{"msg":"原文SHA512哈希不能为空","resultCode":"HTTP_PARAM_ERROR","success":false}
//正确响应
{"data":{"presId":"17131280","seqNo":"BN1628300594156949504"},"success":true}