| 接口名称 | 申请证书 |
| URL | [ POST ] /api/ssl/v3/order/{product_code}/create |
| 功能 | 申请SSL证书 |
Path参数
| 参数名称 | 参数类型 | 必填 | 说明 |
|---|---|---|---|
| product_code | string | 必需 | 证书产品代码 |
Query参数
| 参数名称 | 参数类型 | 必填 | 说明 |
|---|---|---|---|
| _format | string | 必需 | 接口数据格式 目前支持 json |
Body参数
Content-Type: application/json| 参数名称 | 参数类型 | 必填 | 说明 |
|---|---|---|---|
| period | integer | 可选 | 证书购买年数 sectigo :1-5年 digicert/geotrust/rapidssl/thawte :1-3年 如未提供该参数, 默认为 1年 |
| renew_id | string | 可选 | 续费订单编号 仅续费订单需要提供 原先的订单编号 orderId |
| common_name | string | 可选 | 域名/通用名 证书的主域名,如未提供,将使用CSR里面的 common name |
| csr | string | 可选 | 证书签名请求代码 如未提供,将按 common_name 自动生成CSR |
| dcv_method | string | 可选 | 域名验证方式 sectigo :email,http,https,dns digicert/geotrust/rapidssl/thawte :email,http,dns 如未提供,默认使用 dns 通配符域名 仅支持dns 或 email验证 IP地址证书 仅支持文件验证 |
| 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 的顺序排列每个域名对应的邮箱 |
| admin_firstname | string | 必需 | 联系人 名字 |
| admin_lastname | string | 必需 | 联系人 姓 |
| admin_phone | string | 必需 | 联系人 电话 |
| admin_email | string | 必需 | 联系人 EMAIL |
| admin_title | string | 必需 | 联系人 职务 |
| tech_firstname | string | 可选 | 技术联系人 名字 |
| tech_lastname | string | 可选 | 技术联系人 姓 |
| tech_phone | string | 可选 | 技术联系人 电话 |
| tech_email | string | 可选 | 技术联系人 EMAIL |
| tech_title | string | 可选 | 技术联系人 职务 |
| org_name | string | 可选 | 组织名称 |
| org_division | string | 可选 | 部门名称 |
| org_region | string | 可选 | 省份 |
| org_city | string | 可选 | 城市 |
| org_addressline1 | string | 可选 | 地址(街道门牌号) |
| org_addressline2 | string | 可选 | 地址(街道门牌号) org_addressline1 超长时,这里补充 |
| org_phone | string | 可选 | 组织电话 |
| org_country | string | 可选 | 国家地区 |
| org_postalcode | string | 可选 | 邮编 |
请求示例 : 单域名证书申请 ,采用dns验证
{
"period": 2,
"csr": "-----BEGIN CERTIFICATE REQUEST-----\nMIIBNTCB3QIBADB7MQswCQYDVQQGEwJNVBAoMGOe9kee7nOenkeaKgOaciexhs916vjaEnAXKqZbU/cXzdY+\nDCAon7+X3qBDKWdFmhK3/zdcDTIMIBZtIKl2pMXF04vqOKAAMAoGCCqBHM9VAYN1\nA0cAMEQCIBT9RwjN5NjmbnXvaOT57B5nOXgKJ9ZtYXlMI3NJA==\n-----END CERTIFICATE REQUEST-----",
"common_name": "777758.xyz",
"dcv_method": "dns",
"admin_firstname": "伟",
"admin_lastname": "李",
"admin_phone": "13000000000",
"admin_title": "工程师",
"admin_email": "tech@domain.com"
}
请求示例 : 单域名证书申请 ,采用email验证
{
"period": 2,
"csr": "-----BEGIN CERTIFICATE REQUEST-----\nMIIBNTCB3QIBADB7MQswCQYDVQQGEwJNVBAoMGOe9kee7nOenkeaKgOaciexhs916vjaEnAXKqZbU/cXzdY+\nDCAon7+X3qBDKWdFmhK3/zdcDTIMIBZtIKl2pMXF04vqOKAAMAoGCCqBHM9VAYN1\nA0cAMEQCIBT9RwjN5NjmbnXvaOT57B5nOXgKJ9ZtYXlMI3NJA==\n-----END CERTIFICATE REQUEST-----",
"common_name": "777758.xyz",
"dcv_method": "email",
"approver_email": "admin@domain.xyz",
"dns_names": "domain2.com,domain3.com",
"approver_emails": "admin@domain2.com,admin@domain3.com",
"admin_firstname": "伟",
"admin_lastname": "李",
"admin_phone": "13000000000",
"admin_title": "工程师",
"admin_email": "tech@domain.com"
}
请求示例 : OV EV SSL证书申请
{
"period": 2,
"csr": "-----BEGIN CERTIFICATE REQUEST-----\nMIIBNTCB3QIBADB7MQswCQYDVQQGEwJNVBAoMGOe9kee7nOenkeaKgOaciexhs916vjaEnAXKqZbU/cXzdY+\nDCAon7+X3qBDKWdFmhK3/zdcDTIMIBZtIKl2pMXF04vqOKAAMAoGCCqBHM9VAYN1\nA0cAMEQCIBT9RwjN5NjmbnXvaOT57B5nOXgKJ9ZtYXlMI3NJA==\n-----END CERTIFICATE REQUEST-----",
"common_name": "777758.xyz",
"dcv_method": "dns",
"admin_firstname": "伟",
"admin_lastname": "李",
"admin_phone": "13000000000",
"admin_title": "工程师",
"admin_email": "tech@domain.com",
"org_name": "苏州网络科技公司",
"org_division": "技术部",
"org_addressline1": "xx区xxx路1111111",
"org_city": "苏州",
"org_country": "CN",
"org_phone": "010-55255555",
"org_postalcode": "100000",
"org_region": "江苏"
}
请求示例 : 代码签名证书申请
{
"period": 1,
"admin_firstname": "明",
"admin_lastname": "李",
"admin_phone": "020-000000",
"admin_email": "aaa@domain.com",
"admin_title": "IT",
"org_name": "广州市网络科技有限公司",
"org_division": "IT",
"org_region": "广东",
"org_city": "广州",
"org_addressline1": "兴业路112号",
"org_addressline2": "",
"org_phone": "020-00000000",
"org_country": "CN",
"org_postalcode": "510000",
"recipient": "李明",
"recipient_phone": "020-00000000",
"recipient_address": "兴业路112号",
"recipient_province": "广东",
"recipient_city": "广州"
}
请求示例 : 申请 企业型邮件签名证书
{
"period": 1,
"admin_firstname": "明",
"admin_lastname": "刘",
"admin_phone": "13900000000",
"admin_email": "dev@domain.com",
"admin_title": "IT",
"org_name": "深圳网络科技有限公司",
"org_division": "IT",
"org_region": "广东",
"org_city": "深圳",
"org_addressline1": "南山区南头街道XX路111号",
"org_addressline2": "",
"org_phone": "0755-00000000",
"org_country": "CN",
"org_postalcode": "518000",
"csr": "-----BEGIN CERTIFICATE REQUEST-----\nMIIC5TCCAc0CAQAwdzEXMBUGA1UEAwwOZGV2QHNzbGFhYS5jb20xLTArBgNVBAoM\nJOa3seWcs+aXoOW/p+aVsOWtl+en8IMuvjeGDSROuPzdJ4Y8wTi0SFUWCyh6teqdO2h5Fy4qTPX2j7/s0oz\nIuZ0+h/D7h5hALz21ND3Sixtk5KwSC3n0Q==\n-----END CERTIFICATE REQUEST-----"
}
返回值
| 参数名称 | 参数类型 | 必填 | 说明 |
|---|---|---|---|
| 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 . key | string | 可选 | 私钥 |
| 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": "string",
"data": {
"status": "string",
"productCode": "string",
"dcvStatus": 0,
"uuid": "string",
"orderId": "string",
"vendorId": "string",
"commonName": "string",
"dnsNames": "string",
"refundRequest": 0,
"refundStatus": 0,
"paymentStatus": 0,
"price": 0,
"created": "string",
"uniquevalue": "string",
"csr": "string",
"key": "string",
"dcvList": [
{
"domainName": "string",
"dcvMethod": "string",
"dcvEmail": "string",
"dcvStatus": "string",
"value": "string",
"validationDomain": "string",
"prefix": "string",
"dnsType": "string",
"dnsValue": "string",
"filename": "string",
"content": "string",
"path": "string"
}
],
"adminContact": {
"admin_firstname": "string",
"admin_lastname": "string",
"admin_phone": "string",
"admin_email": "string",
"admin_title": "string"
},
"techContact": {
"tech_firstname": "string",
"tech_lastname": "string",
"tech_phone": "string",
"tech_email": "string",
"tech_title": "string"
},
"organizationContact": {
"org_city": "string",
"org_division": "string",
"org_region": "string",
"org_name": "string",
"org_phone": "string",
"org_addressline1": "string",
"org_addressline2": "string",
"org_country": "string",
"org_postalcode": "string"
},
"balance": "string",
"fee": 0
}
}



