获取证书列表

GET

/openapi/v3/certs

分页获取证书列表。

查询参数

参数	类型	必填	说明
page	int	否	页码，默认 1
page_size	int	否	每页数量，默认 10，最大 100

响应字段

参数	类型	说明
certs	certificate array	证书对象列表，具体字段见获取证书详情
total	int	证书总个数

请求示例

curl -X GET 'https://api.certcloud.cn/openapi/v3/certs?page=1&page_size=20' \
  -H 'X-CC-Auth-Key: your-auth-key' \
  -H 'X-CC-Key-ID: your-key-id'

const response = await fetch('https://api.certcloud.cn/openapi/v3/certs?page=1&page_size=20', {
  headers: {
    'X-CC-Auth-Key': 'your-auth-key',
    'X-CC-Key-ID': 'your-key-id',
  }
})

req, _ := http.NewRequest("GET", "https://api.certcloud.cn/openapi/v3/certs?page=1&page_size=20", nil)
req.Header.Set("X-CC-Auth-Key", "your-auth-key")
req.Header.Set("X-CC-Key-ID", "your-key-id")
resp, _ := http.DefaultClient.Do(req)

import requests

resp = requests.get(
    'https://api.certcloud.cn/openapi/v3/certs?page=1&page_size=20',
    headers={
        'X-CC-Auth-Key': 'your-auth-key',
        'X-CC-Key-ID': 'your-key-id',
    }
)

响应示例

200成功

{
  "code": "success",
  "data": {
    "total": 50,
    "certs": [
      {
        "id": "cert-xxx",
        "common_name": "example.com",
        "dns_names": ["example.com", "www.example.com"],
        "thumbprint": "A1B2C3...",
        "pem": "-----BEGIN CERTIFICATE-----...",
        "not_before": "2024-01-01 00:00:00",
        "not_after": "2025-01-01 00:00:00",
        "ica_pem": "-----BEGIN CERTIFICATE-----...",
        "created_at": "2024-01-01 00:00:00",
        "revoked": false,
        "status": 1,
        "issuer": "TrustAsia RSA DV TLS CA",
        "brand": "TrustAsia",
        "audit_type": "DV",
        "cross_chain": 0,
        "chain_id": 0,
        "validity_days": 365
      }
    ]
  }
}