签约状态查询

接口说明

[!NOTE]
当只传applyNo表示查看的是整个合同的状态。如加入签约方信息表示查询的是合同中相应签约方的状态

http请求方式

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

http请求地址

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

http请求参数

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

参数 类型 是否必填 默认值 说明
applyNo string * 合同编号
fullName string ? 签约人名称
identityCard string ? 签约人证件号
identityType int ? 证件类型 1身份证, 2护照, 3台胞证, 4港澳居民来往内地通行证, 11营业执照, 12统一社会信用代码, 20子账号, 99其他

代码实现

JAVA实现
 Map<String, Object> params = bodyParams;
        String url = SERVICE_URL + "/v2/sign/status";
        params.put("applyNo", "APL170360XXXXXX");
        String str = HttpClientUtils.init().getPost(url, null, params, true);
        System.out.println(str);
PHP实现
//构建请求工具
$requestUtils=new RequestUtils($serviceUrl, $appkey, $appSecret);
//初始化合同参数
//不传fullName,identityCard,identityType表示的是整个合同的签约状态
$request=array(
    "applyNo" => "APL0000XXXXXXXXX", //TODO *
    "fullName" => "易XX", //TODO *
    "identityCard" => "5002XXXXXXXXXXXXXXXXXX", //TODO *
    "identityType" => 1, //TODO *
);
$response=$requestUtils->doPost("/v2/sign/status",$request);

http返回参数

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

参数 类型 是否必返回 说明
success bool * 成功true;异常false
msg string ? 异常时,返回异常原因
resultCode string ? 异常时返回
data int ? 0 :未签 1 :已签 2:拒签 3:已保全

[!NOTE]
返回结果,参考:

//正确响应:
{"success":true,"data":1}

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

results matching ""

    No results matching ""