获取签约查看链接

接口说明

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

results matching ""

    No results matching ""