查询证书有效期
接口说明
[!NOTE]
查询证书有效期注：支持两种模式查询 idCard+apl 和单独的authSerialNos认证流水号查询
；传了idCard必须传apl号，用于校验证件号是否通过平台签署过合同；
没有传idCard+apl的情况下，必须传认证流水号
http请求方式
[!NOTE]
POST form-data
http请求地址
[!NOTE]
$SERVICE_URL/v2/sign/cert/query #其中$SERVICE_URL为生产或测试的地址
http请求参数
[!NOTE]
除公共必填参数外，还需要传以下参数
| 参数 | 类型 | 是否必填 | 默认值 | 说明 |
|---|---|---|---|---|
| idCard | String | + | 证件号，apl不为空时必传 | |
| apl | String | + | 在平台签过合同的apl；idCard不为空时必传 | |
| authSerialNos | String | ? | 认证流水号，多个用逗号隔开;（最多支持10个查询） |
代码实现
JAVA实现
Map<String, Object> params = bodyParams;
String url = SERVICE_URL + "/v2/sign/cert/query";
params.put("idCard", "4331XXXXXXXX9");
params.put("apl", "APLXXXXXXXXXXXX32");
String str = HttpClientUtils.init().getPost(url, null, params, true);
System.out.println(str);
http返回参数
[!NOTE]
返回response为application/json的数据，其字段说明如下
| 参数 | 类型 | 是否必返回 | 说明 |
|---|---|---|---|
| success | bool | * | 成功true；异常false |
| msg | string | ? | 异常时，返回异常原因 |
| data | JSONArray | ? | 证书有效期列表 |
| resultCode | string | ? | 异常时返回 |
data参数说明
| 参数 | 类型 | 是否必返回 | 说明 |
|---|---|---|---|
| certExpireTime | string | * | 证书过期时间 |
| certSn | string | * | 证书序列号，实际是证书的id，非ca盖上去的序列号 |
| authSerialNo | string | ? | 通过认证序列号查询的情况下有 |
[!NOTE]
返回结果，参考：
//正确响应：
{"data":[{"certExpireTime":"2027-06-10 17:23:41","certSn":"BF74B397AE3CB1A90AAD69C11C6A6A27"}],"success":true}