获取签约查看链接
接口说明
[!NOTE]
通过该接口获取签约完成后的合同查看链接地址。链接地址有效期是7天,超过7天后需要重新获取连接地址
http请求方式
[!NOTE]
POST application/x-www-form-urlencoded
http请求地址
[!NOTE]
$SERVICE_URL/v2/sign/linkAnonyDetail #其中$SERVICE_URL为生产或测试的地址
http请求参数
除公共必填参数外,还需要传以下参数
参数 | 类型 | 是否必填 | 默认值 | 说明 |
---|---|---|---|---|
applyNo | string | * | 合同编号 | |
viewMode | int | ? | PC端查看合同模式 1查看合同页面隐藏两边信息 | |
useCustomDomain | string | ? | 1使用自定义域名(注:嵌入小程序推荐设置该参数) |
代码实现
JAVA实现
Map<String, Object> params = bodyParams;
String url = SERVICE_URL + "/v2/sign/linkAnonyDetail";
params.put("applyNo", "APL18XXXXX"); //发起合同签署接口返回的APL编号
params.put("fullName", "唐XXX"); //发起合同签署接口需要手动签署对象的姓名
params.put("identityCard", "50023XXXXXXX"); //发起合同签署接口中需要手动签署对象的证件号
params.put("identityType", 1); //证件类型,个人1 ,企业11
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/linkAnonyDetail",$request);
http返回参数
[!NOTE]
返回response为application/json的数据,其字段说明如下
参数 | 类型 | 是否必返回 | 说明 |
---|---|---|---|
success | bool | * | 成功true;异常false |
msg | string | ? | 异常时,返回异常原因 |
resultCode | string | ? | 异常时返回 |
data | string | ? | 合同查看地址,成功时返回 |
[!NOTE]
返回结果,参考:
//正确响应:
{"data":"http://xxx.xxx.xxx","success":true}
//错误响应:
{"msg":"app_secret不可用","resultCode":"HTTP_PARAM_ERROR","success":false}