订阅期内证书续期

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 私钥来源。电子签名认证证书只能使用 esign 或 usb-token，其他产品详见CSR 来源
∟ common_name	string	按需	通用名称。SSL 证书必须
∟ dns_names	array[string]	否	备用名称；部分产品支持修改，参考"产品列表"章节
∟ sign_hash	string	是	签名摘要
∟ chain_id	integer	否	签发 ICA 配置 ID（1～2147483647），从产品候选证书链获取；切换 ICA 时不带 order_id 查询候选。 省略或 0 沿用订单签发配置；显式选择仅支持当前 CA 账户下、产品已开放且匹配实际算法的 ICA，是否支持取决于产品和签发服务。 与 cross_chain 同时指定时，必须来自同一 ICA 项。
∟ cross_chain	integer	否	候选路径编号（1000～9999），随本次业务受理保存；沿用 ICA 时可带 order_id 查询其候选路径。 省略或 0 保留已有链族偏好；-1 关闭交叉链、1 开启交叉链，均不删除已保存的路径编号。 默认规则及偏好生效范围见证书链选择与交付；仅调整已签发证书的交付路径时，使用设置订单交付偏好。
∟ 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

电子签名认证证书

续期 trustasia_ide_pic、trustasia_ide_pipc、trustasia_ide_bipc 或 trustasia_ide_bipro 时，必须按审核信息保存的私钥方案使用新规则：

• private_key_custody=true（包括历史数据未记录）：certificate.csr_from 只能为 esign。
• private_key_custody=false：certificate.csr_from 只能为 usb-token。
• 两种方式都不传 certificate.csr。

续期不沿用旧订单的上传、粘贴或其他 CSR 来源。详见电子签名认证证书。

返回数据

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

以下示例演示同时选择 ICA 和交付路径。请将 7、1002 替换为同一候选项中且适用于当前订单的值；沿用现有配置时省略这两个字段。

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": "example.com",
      "dns_names": ["example.com"],
      "sign_hash": "SHA256",
      "chain_id": 7,
      "cross_chain": 1002
    }
  }'

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: 'example.com',
      dns_names: ['example.com'],
      sign_hash: 'SHA256',
      chain_id: 7,
      cross_chain: 1002
    }
  })
})
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": "example.com",
    "dns_names":   []string{"example.com"},
    "sign_hash":   "SHA256",
    "chain_id":    7,
    "cross_chain": 1002,
  },
}
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': 'example.com',
            'dns_names': ['example.com'],
            'sign_hash': 'SHA256',
            'chain_id': 7,
            'cross_chain': 1002
        }
    }
)
data = response.json()

200成功

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