获取签署场景存证文件链接

服务说明

[!NOTE]
该接口只支持手动签署过程中有添加签署现场图片、视频、签署过程中人脸识别视频等证据下载，获取的是下载的URL地址，有效期为30分钟。

http请求方式

[!NOTE]
POST application/x-www-form-urlencoded

http请求地址

[!NOTE]
$SERVICE_URL/v2/sign/evidenceLinkFile #其中$SERVICE_URL为生产或测试的地址

http请求参数

除公共必填参数外，还需要传以下参数

参数	类型	是否必填	默认值	说明
applyNo	string	*		合同编号;applyNo和businessNo需只传一个（合同发起接口传返回的APL编号或者是自定义的业务编号）
fullName	string	*		签约人名称（合同发起接口中传入的签署人姓名）
identityCard	string	*		签约人证件号（合同发起接口中传入的签署人证件号）
identityType	int	*		证件类型 1身份证, 2护照, 3台胞证, 4港澳居民来往内地通行证, 11营业执照, 12统一社会信用代码, 20子账号, 99其他
evidenceType	int	*		证据类型,0签约过程中的现场存证图片,1签约过程中的现场存证视频,2签约过程中的人脸识别视频

代码实现

JAVA实现

RequestUtils requestUtils=RequestUtils.init(SERVICE_URL,APP_KEY,APP_SECRET);//建议生成为spring bean
//构建请求参数
Map<String,Object> params=new HashMap<>();
params.put("applyNo","XXX"); //TODO *
params.put("fullName","易XX");
params.put("identityCard","500240XXXXXXXXXXXXXXX");
params.put("identityType",1);
params.put("evidenceType",0);//证据类型,0图片,1视频,2人脸证据
ResultInfo<JSONObject> ri= requestUtils.doPost("/v2/sign/evidenceLinkFile",params);

PHP实现

//构建请求工具
$requestUtils=new RequestUtils($serviceUrl, $appkey, $appSecret);

//初始化合同参数
$request=array(
    "applyNo" => "APL0000XXXXXXXXX", //TODO ? applyNo和businessNo之一必传
    "businessNo" => "NO0000XXXXXXXXX", //TODO ? applyNo和businessNo之一必传
    "fullName" => "易XX", //TODO *
    "identityCard" => "5002XXXXXXXXXXXXXXXXXX", //TODO *
    "identityType" => 1, //TODO *
    "evidenceType" => 0 //证据类型,0图片,1视频,2人脸证据
);
$response=$requestUtils->doPost("/v2/sign/evidenceLinkFile",$request);

http返回参数

[!NOTE]
返回response为application/json的数据，其字段说明如下

参数	类型	是否必返回	说明
success	bool	*	成功true；异常false
msg	string	?	异常时，返回异常原因
resultCode	string	?	异常时返回
data	string	?	url地址，成功时返回

[!NOTE]
返回结果，参考：

//正确响应：
{"data":{links:["http://wwww.xxxxx.xxx"]},"success":true}

//错误响应：
{"msg":"app_secret不可用","resultCode":"HTTP_PARAM_ERROR","success":false}

results matching ""

No results matching ""