获取文件下载链接
接口说明
[!NOTE]
获取最新的合同文件下载地址,可能文件还没有签署完成,建议合同签署完成后再获取下载地址。下载链接地址有效期是30分钟,超过30分钟需要重新请求下载链接地址
http请求方式
[!NOTE]
POST application/x-www-form-urlencoded
http请求地址
[!NOTE]
$SERVICE_URL/v2/sign/linkFile #其中$SERVICE_URL为生产或测试的地址
http请求参数
除公共必填参数外,还需要传以下参数
参数 | 类型 | 是否必填 | 默认值 | 说明 |
---|---|---|---|---|
applyNo | string | * | 合同编号 |
特殊说明
[!NOTE]
合同下载链接地址有效期为30分钟,超过30分钟后需要重新通过接口获取链接地址
代码实现
JAVA实现
Map<String, Object> params = bodyParams;
String url = SERVICE_URL + "/v2/sign/linkFile";
params.put("applyNo", "APL1XXXXXXX");//APL文件编号
String str = HttpClientUtils.init().getPost(url, null, params, true);
System.out.println(str);
PHP实现
//构建请求工具
$requestUtils=new RequestUtils($serviceUrl, $appkey, $appSecret);
//初始化合同参数
$request=array(
"applyNo" => "APL0000XXXXXXXXX"//TODO *
);
$response=$requestUtils->doPost("/v2/sign/linkFile",$request);
http返回参数
[!NOTE]
返回response为application/json的数据,其字段说明如下
参数 | 类型 | 是否必返回 | 说明 |
---|---|---|---|
success | bool | * | 成功true;异常false |
msg | string | ? | 异常时,返回异常原因 |
resultCode | string | ? | 异常时返回 |
data | string | ? | 文件url地址,成功时返回 |
[!NOTE]
返回结果,参考:
//正确响应:
{"data":"http://xxx.xxx.xxx","success":true}
//错误响应:
{"msg":"app_secret不可用","resultCode":"HTTP_PARAM_ERROR","success":false}