获取文件下载链接

接口说明

[!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实现
RequestUtils requestUtils=RequestUtils.init(SERVICE_URL,APP_KEY,APP_SECRET);//建议生成为spring bean
//构建请求参数
Map<String,Object> params=new HashMap<>();
params.put("applyNo","XXX"); //TODO *
ResultInfo<String> ri= requestUtils.doPost("/v2/sign/linkFile",params);
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}

results matching ""

    No results matching ""