接口名称 | 重新签发证书 |
URL | [ POST ] /api/ssl/v3/order/{uuid}/reissue |
功能 | 重签发SSL证书, 用于重签SSL证书。只有当SSL证书状态为已签发时,才允许被重签, 多域名证书重签发,如果新增加域名,会产生费用 |
Path参数
参数名称 | 参数类型 | 必填 | 说明 |
---|---|---|---|
uuid | string | 必需 | uuid 证书的uuid编号 |
Query参数
参数名称 | 参数类型 | 必填 | 说明 |
---|---|---|---|
_format | string | 必需 | 接口数据格式 目前支持 json |
Body参数
Content-Type: application/json参数名称 | 参数类型 | 必填 | 说明 |
---|---|---|---|
csr | string | 可选 | 证书签名请求代码 如未提供,将按 common_name 自动生成CSR |
common_name | string | 可选 | 域名/通用名 证书的主域名,如未提供,将使用CSR里面的 common name |
dcv_method | string | 必需 | 域名验证方式 ectigo :email,http,https,dns digicert/geotrust/rapidssl/thawte :email,http,dns |
dns_names | string | 可选 | 附加域名 仅多域名证书需要提供,多个域名之间用英文逗号隔开 |
approver_email | string | 可选 | 参数 common_name 的验证邮箱 当 dcv_method 为 email 时需要提供,common_name 的验证邮箱,CA将发送验证邮件到该邮箱,如未提供,默认发送到 admin@ 邮箱 |
approver_emails | string | 可选 | 附加域名的验证邮箱 当 dcv_method 为 email 时需要提供,dns_names 的验证邮箱,CA将发送验证邮件到该邮箱,如未提供,默认发送到 admin@ 邮箱,多个邮箱之间用英文逗号隔开,请按dns_names 的顺序排列每个域名对应的邮箱 |
请求示例 : 证书重签发 采用dns验证
{ "common_name": "domain2.xyz", "csr": "-----BEGIN CERTIFICATE REQUEST-----\nMIICkDMt1EZi0PKNyCnXd3U70wL6x\nIurwKobX+/ZLp+9pCmbPxRiP9lcUtNF3owstsOOeaD8tNMMblWXZTxsZKgfmy7Hn\nsddnQgCH6MF8nL7o+RKKbLrzxemDhuMTzi+VA6ueXW/LDIjP\n-----END CERTIFICATE REQUEST-----", "dcv_method": "dns" }
请求示例 : 多域名证书重签发 采用dns验证
{ "common_name": "domain2.xyz", "csr": "-----BEGIN CERTIFICATE REQUEST-----\nMIICkDMt1EZi0PKNyCnXd3U70wL6x\nIurwKobX+/ZLp+9pCmbPxRiP9lcUtNF3owstsOOeaD8tNMMblWXZTxsZKgfmy7Hn\nsddnQgCH6MF8nL7o+RKKbLrzxemDhuMTzi+VA6ueXW/LDIjP\n-----END CERTIFICATE REQUEST-----", "dcv_method": "dns", "dns_names": "domain1.com,domain2.com,domain3.com" }
请求示例 : 多域名证书重签发 采用email验证
{ "common_name": "domain2.xyz", "csr": "-----BEGIN CERTIFICATE REQUEST-----\nMIICkDMt1EZi0PKNyCnXd3U70wL6x\nIurwKobX+/ZLp+9pCmbPxRiP9lcUtNF3owstsOOeaD8tNMMblWXZTxsZKgfmy7Hn\nsddnQgCH6MF8nL7o+RKKbLrzxemDhuMTzi+VA6ueXW/LDIjP\n-----END CERTIFICATE REQUEST-----", "dcv_method": "email", "approver_email": "admin@domain2.xyz", "dns_names": "domain1.com,domain2.com,domain3.com", "approver_emails": "admin@domain1.com,admin@domain2.com,admin@domain3.com" }
返回值
参数名称 | 参数类型 | 必填 | 说明 |
---|---|---|---|
code | integer | 必需 | 状态码 成功将返回 200 |
message | string | 必需 | 状态描述 如请求出错,显示具体错误信息 |
data | object | 可选 | |
data . status | string | 可选 | 证书状态 包括如下状态: PEDNDING COMPLETE CANCELLED EXPIRED FAILED |
data . productCode | string | 可选 | 证书产品代码 |
data . dcvStatus | integer | 可选 | 域名验证状态 |
data . uuid | string | 可选 | uuid 证书的uuid编号 |
data . orderId | string | 可选 | 订单id |
data . vendorId | string | 可选 | CA订单编号 |
data . commonName | string | 可选 | 证书主域名 |
data . dnsNames | string | 可选 | 附加域名 仅多域名证书有该项 |
data . refundRequest | integer | 可选 | 是否发送取消证书请求 |
data . refundStatus | integer | 可选 | 退款状态 |
data . paymentStatus | integer | 可选 | 证书付款状态 |
data . price | integer | 可选 | 价格 |
data . created | string | 可选 | 建立日期 |
data . uniquevalue | string | 可选 | 域名控制权验证码 仅sectigo 部分订单有该项 |
data . csr | string | 可选 | 证书签名请求代码 如未提供,将按 common_name 自动生成CSR |
data . dcvList | array | 可选 | 域名验证信息 |
data . dcvList . [] . domainName | string | 可选 | 域名 |
data . dcvList . [] . dcvMethod | string | 可选 | 验证方式 sectigo :email,http,https,dns digicert/geotrust/rapidssl/thawte :email,http,dns |
data . dcvList . [] . dcvEmail | string | 可选 | 采用DNS验证时,CA发送验证邮件到该邮箱 |
data . dcvList . [] . dcvStatus | string | 可选 | 域名验证状态 |
data . dcvList . [] . value | string | 可选 | 验证值 |
data . dcvList . [] . validationDomain | string | 可选 | 采用DNS验证时,CA检测的域名 |
data . dcvList . [] . prefix | string | 可选 | 采用DNS验证时的主机名 |
data . dcvList . [] . dnsType | string | 可选 | 采用DNS验证时的DNS记录类型 |
data . dcvList . [] . dnsValue | string | 可选 | 采用DNS验证时的记录值 |
data . dcvList . [] . filename | string | 可选 | 采用文件验证时的文件名 |
data . dcvList . [] . content | string | 可选 | 采用文件验证时的文件内容 |
data . dcvList . [] . path | string | 可选 | 采用文件验证时的验证网址 |
data . adminContact | object | 可选 | 证书联系人 |
data . adminContact . admin_firstname | string | 可选 | 联系人 名字 |
data . adminContact . admin_lastname | string | 可选 | 联系人 姓 |
data . adminContact . admin_phone | string | 可选 | 联系人 电话 |
data . adminContact . admin_email | string | 可选 | 联系人 EMAIL |
data . adminContact . admin_title | string | 可选 | 联系人 职务 |
data . techContact | object | 可选 | 技术联系人 |
data . techContact . tech_firstname | string | 可选 | 技术联系人 名字 |
data . techContact . tech_lastname | string | 可选 | 技术联系人 姓 |
data . techContact . tech_phone | string | 可选 | 技术联系人 电话 |
data . techContact . tech_email | string | 可选 | 技术联系人 EMAIL |
data . techContact . tech_title | string | 可选 | 技术联系人 职务 |
data . organizationContact | object | 可选 | 组织信息 |
data . organizationContact . org_city | string | 可选 | 城市 |
data . organizationContact . org_division | string | 可选 | 部门名称 |
data . organizationContact . org_region | string | 可选 | 省份 |
data . organizationContact . org_name | string | 可选 | 组织名称 |
data . organizationContact . org_phone | string | 可选 | 组织电话 |
data . organizationContact . org_addressline1 | string | 可选 | 地址(街道门牌号) |
data . organizationContact . org_addressline2 | string | 可选 | 地址(街道门牌号) org_addressline1 超长时,这里补充 |
data . organizationContact . org_country | string | 可选 | 国家地区 |
data . organizationContact . org_postalcode | string | 可选 | 邮编 |
data . balance | string | 可选 | 账户余额 |
data . fee | integer | 可选 | 产生的费用 |
返回示例
{ "code": 200, "message": "Command completed successfully", "data": { "status": "PENDING", "productCode": "PositiveSSL", "dcvStatus": 0, "uuid": "9e3dd2b5-d98b-447b-9cc6-160fa0ce258a", "orderId": "IS220303PUM3", "vendorId": "222222222", "commonName": "test.domain.com", "dnsNames": "", "refundRequest": 0, "refundStatus": 0, "paymentStatus": 1, "price": 1, "created": "2024-01-03 20:41", "uniquevalue": "", "csr": "-----BEGIN CERTIFICATE REQUEST-----\nMIIC/jCCAeYCAQAwgY8xGDAWBgNVBAMMD3Rlc3Quc3NsYWFhLmNvbTEYMBYGA1UE\nCgwPdGVzdC5zc2xhYWEuY29tMRgwFgYDVQQLDA90ZXN0LnNzbGFhZc0VErsGuOEGsdxVy4M6lFb9ub\nmc/b59hMhUqSeuvBFVMIcXS3PpSAEWdFJ93pPWFQ/S7AtuAzPKxtkcxWiqSy29AN\nLP4=\n-----END CERTIFICATE REQUEST-----", "dcvList": [ { "domainName": "test.domain.com", "dcvMethod": "email", "dcvEmail": "admin@domain.com", "dcvStatus": "notCompleted", "value": "", "validationDomain": "", "prefix": "", "dnsType": "", "dnsValue": "", "filename": "", "content": "", "path": "" } ], "adminContact": { "admin_firstname": "yong", "admin_lastname": "liu", "admin_phone": "020-00000000", "admin_email": "dev@domain.com", "admin_title": "IT" }, "techContact": { "tech_firstname": "", "tech_lastname": "", "tech_phone": "", "tech_email": "", "tech_title": "" }, "organizationContact": { "org_city": "", "org_division": "", "org_region": "", "org_name": "", "org_phone": "", "org_addressline1": "", "org_addressline2": "", "org_country": "", "org_postalcode": "" }, "balance": "81.29", "fee": 0 } }