数据签发起说明

接口说明

[!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 ""