重颁发

POST

/openapi/v3/orders/:id/reissue

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

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	否	是否不更新加密证书密钥。默认更新。原证书是国密双证书时，此参数才会生效
∟ 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 时使用的云签密钥访问控制码提示

返回数据

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

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": "test.isw.app",
      "dns_names": ["test.isw.app"],
      "sign_hash": "SHA256"
    }
  }'

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: '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/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': 'test.isw.app',
            'dns_names': ['test.isw.app'],
            'sign_hash': 'SHA256'
        }
    }
)
data = response.json()

200成功

{
  "data": {
    "certificate": {
      "id": "4itFJOgL"
    }
  },
  "code": "success"
}