订阅期内证书续期

POST

/openapi/v3/orders/:id/renew

订阅期内订单可通过该接口提交证书续期。具体适用条件以产品与 CA 规则为准。完整的 订阅期内证书续期 流程见业务流程章节。

Path 参数

参数	类型	必填	说明
id	string	是	订单 ID

Body 参数 application/json

参数	类型	必填	说明
certificate	object	是	证书详情
∟ csr	string	按需	证书请求文件。是否需要提交及提交时机取决于 csr_from 与产品规则，详见CSR 来源
∟ csr_from	string	否	CSR 私钥来源。默认不用传或为空，详见CSR 来源
∟ common_name	string	按需	通用名称。SSL 证书必须
∟ dns_names	array[string]	否	备用名称；部分产品支持修改，参考"产品列表"章节
∟ sign_hash	string	是	签名摘要
∟ un_modify_key	bool	否	是否不更新加密证书密钥。默认更新。原证书是国密双证书时，此参数才会生效
dcv_method	string	否	域名验证方式
persist_until	integer	否	仅当 dcv_method=dns-persist 时生效。验证值有效期（UNIX 秒）；0 表示无限期；不传则沿用原订单值
persist_policy	string	否	仅当 dcv_method=dns-persist 时生效。授权范围：fqdn（默认）或 wildcard

返回数据

参数名称	类型	描述
certificate	object	证书
∟ id	string	证书 ID

curl -X POST 'https://api.certcloud.cn/openapi/v3/orders/TIT6R0qv/renew' \
  -H 'Content-Type: application/json' \
  -H 'X-CC-Auth-Key: your-auth-key' \
  -H 'X-CC-Key-ID: your-key-id' \
  -d '{
    "certificate": {
      "csr": "-----BEGIN CERTIFICATE REQUEST-----\n...\n-----END CERTIFICATE REQUEST-----\n",
      "common_name": "test.isw.app",
      "dns_names": ["test.isw.app"],
      "sign_hash": "SHA256"
    }
  }'

const response = await fetch('https://api.certcloud.cn/openapi/v3/orders/TIT6R0qv/renew', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-CC-Auth-Key': 'your-auth-key',
    'X-CC-Key-ID': 'your-key-id',
  },
  body: JSON.stringify({
    certificate: {
      csr: '-----BEGIN CERTIFICATE REQUEST-----\n...\n-----END CERTIFICATE REQUEST-----\n',
      common_name: 'test.isw.app',
      dns_names: ['test.isw.app'],
      sign_hash: 'SHA256'
    }
  })
})
const data = await response.json()

body := map[string]interface{}{
  "certificate": map[string]interface{}{
    "csr":         "-----BEGIN CERTIFICATE REQUEST-----\n...\n-----END CERTIFICATE REQUEST-----\n",
    "common_name": "test.isw.app",
    "dns_names":   []string{"test.isw.app"},
    "sign_hash":   "SHA256",
  },
}
jsonBody, _ := json.Marshal(body)
req, _ := http.NewRequest("POST",
  "https://api.certcloud.cn/openapi/v3/orders/TIT6R0qv/renew",
  bytes.NewBuffer(jsonBody))
req.Header.Set("Content-Type", "application/json")
req.Header.Set("X-CC-Auth-Key", "your-auth-key")
req.Header.Set("X-CC-Key-ID", "your-key-id")
resp, err := http.DefaultClient.Do(req)

import requests

response = requests.post(
    'https://api.certcloud.cn/openapi/v3/orders/TIT6R0qv/renew',
    headers={
        'Content-Type': 'application/json',
        'X-CC-Auth-Key': 'your-auth-key',
        'X-CC-Key-ID': 'your-key-id',
    },
    json={
        'certificate': {
            'csr': '-----BEGIN CERTIFICATE REQUEST-----\n...\n-----END CERTIFICATE REQUEST-----\n',
            'common_name': 'test.isw.app',
            'dns_names': ['test.isw.app'],
            'sign_hash': 'SHA256'
        }
    }
)
data = response.json()

200成功

{
  "data": {
    "certificate": {
      "id": "qyZUmlQAr"
    }
  },
  "code": "success"
}