接口名称 | 申请证书 |
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 } }