查询证书

查询证书

一、请求说明

• 请求地址：https://IP:PORT/openapi/ces/v1/certificate/list
• 服务接口名称(即公共参数method的值)： certificate/list
• 请求方式：POST

二、请求参数

无

三、响应参数

data 结果信息	类型	描述
id	String	证书ID
certPurpose	String	证书用途：单双证
signatureCert	CertificateInfoResp	签名证书
encryptionCert	CertificateInfoResp	加密证书
cn	String	证书持有者名称
subject	String	证书主题项
issuer	String	证书颁发者主题项
notBefore	Date	证书生效时间
notAfter	Date	证书失效时间
algorithm	String	签名算法
keySize	Integer	密钥长度
timeStamping	Boolean	是否为时间戳证书

• CertificateInfoResp 证书详情

类型字段	介绍
certSn	证书序列号
cert	证书base64
fingerprint	证书指纹(Sha1 Hex编码)

四、成功示例

JSON示例

{
  "code": 0,
  "requestId":"xxx",
  "data": [
    {
      "algorithm": "SM2",
      "certPurpose": "DOUBLE",
      "cn": "817test",
      "encryptionCert": {
        "cert": "MIIC******2N3k",
        "certSn": "00fa6d3a*****1789b276bf5",
        "fingerprint": "a6a2******e2a9"
      },
      "id": {
        "date": 16607***30000,
        "timestamp": 1660717530
      },
      "issuer": "C=CN,ST=江苏省,L=南京市,CN=testSM2CA",
      "keyPairId": {
        "date": 1660****45000,
        "timestamp": 1660717345
      },
      "keySize": 256,
      "notAfter": 1692253442000,
      "notBefore": 1660717442000,
      "signatureCert": {
        "cert": "MIIC******xg==",
        "certSn": "00b30962fe****db63e312a5",
        "fingerprint": "de68******b53a"
      },
      "subject": "C=CN******test",
      "timeStamping": false
    }
  ],
  "message": "success"
}

五、失败示例

JSON示例

六、SDK请求示例

       // 提供的URL
        String url = "http://172.16.6.76:20501";

        // 您的appKey
        String appKey = "XXX";

        // 您的appSecret
        String appSecret = "XXX";

        // 原客户端
        PkiClient pkiClient = new PkiOkhttpClient(url, appKey, appSecret);

        CertificateRequest request = new CertificateRequest();

        try {
            CertificateResponse response = pkiClient.execute(request);
            // 后续业务
            if (response.isSuccess()) {
                System.out.println("成功：" + response.getResult());
            } else {
                System.out.println("失败：" + response.getBody());
            }
        } catch (ApiException e) {
            e.printStackTrace();
        }