获取 ARI 信息

GET

/openapi/v3/certs/:id/renewal-info

用于获取证书的建议续期窗口期（即 ARI 信息）。客户端可根据返回窗口安排续期。

路径参数

参数	类型	必填	说明
id	string	是	证书 ID

响应字段

参数	类型	说明
retry_after	int	建议重试间隔，单位秒（根据 RFC9773 标准，客户端可以在这个时间之后再次获取 ARI 信息）
suggested_window	object	续期窗口期
.. start	string	续期窗口期开始时间（RFC3339 格式）
.. end	string	续期窗口期结束时间（RFC3339 格式）

请求示例

curl -X GET 'https://api.certcloud.cn/openapi/v3/certs/cert-xxx/renewal-info' \
  -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/cert-xxx/renewal-info', {
  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/cert-xxx/renewal-info", 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/cert-xxx/renewal-info',
    headers={
        'X-CC-Auth-Key': 'your-auth-key',
        'X-CC-Key-ID': 'your-key-id',
    }
)

响应示例

200成功

{
  "data": {
    "retry_after": 43200,
    "suggested_window": {
      "start": "2026-07-26T21:14:24Z",
      "end": "2026-07-30T21:14:24Z"
    }
  },
  "code": "success"
}