数据签发起说明

接口说明

[!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 * 个人传身份证号,企业传营业执照号/统一社会信用代码号
email 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}

results matching ""

    No results matching ""