重颁发

POST

/openapi/v3/orders/:id/reissue

重颁发证书。完整的 重颁发流程 见业务流程章节。

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	否	是否不更新加密证书密钥。默认更新。原证书是国密双证书时，此参数才会生效
∟ validity_days	integer	否	有效期天数
∟ custom_expiration_date	string	否	自定义过期日期
i_know_remove_domain_will_revoke_before_cert	bool	否	重颁发时若需移除域名，需要传这个参数
i_know_will_revoke_last_cert	bool	否	部分产品重颁发会吊销之前的证书，这部分产品只有该参数为 true 才可重颁发
dcv_method	string	否	域名验证方式
persist_until	integer	否	仅当 dcv_method=dns-persist 时生效。重颁发时覆盖原订单绑定；不传沿用原值，0 表示清空/无限期
persist_policy	string	否	仅当 dcv_method=dns-persist 时生效。授权范围：fqdn（默认）或 wildcard
dcv_scope	string	否	域名验证范围；具体支持范围以产品规则为准
vsign_key_pin	string	按需	仅当 csr_from=vsign-cloud-csc 时使用的云签密钥访问控制码
vsign_key_pin_tip	string	否	仅当 csr_from=vsign-cloud-csc 时使用的云签密钥访问控制码提示

电子签名认证证书

重颁发 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/reissue' \
  -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/reissue', {
  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/reissue",
  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/reissue',
    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": "4itFJOgL"
    }
  },
  "code": "success"
}