更新时间:2023-10-11 GMT+08:00

购买SSL证书

功能介绍

购买SSL证书。

请求参数“agree_privacy_protection”必须设置为“true”,才能成功提交购买证书申请。

URI

  • URI格式

    POST /v2/{project_id}/scm/cert/purchase

  • 参数说明

    参数

    是否必选

    参数类型

    描述

    project_id

    String

    项目ID。

请求消息

请求参数

参数

是否必选

参数类型

描述

cert_brand

String

证书品牌。

如:GLOBALSIGN

cert_type

String

证书类型,取值如下:

  • DV_SSL_CERT
  • DV_SSL_CERT_BASIC
  • EV_SSL_CERT
  • EV_SSL_CERT_PRO
  • OV_SSL_CERT
  • OV_SSL_CERT_PRO

domain_type

String

域名类型,取值如下:

  • SINGLE_DOMAIN:单域名类型。
  • MULTI_DOMAIN:多域名类型。
  • WILDCARD:泛域名类型。

effective_time

Integer

证书有效期(年),取值如下:

  • 1:购买有效期为1年的证书。
  • 2:购买有效期为2年的证书。

domain_numbers

Integer

域名数量。

  • “domain_type”选择的是“SINGLE_DOMAIN”“WILDCARD”类型的证书时,域名数量取值为“1”
  • “domain_type”选择的是“MULTI_DOMAIN”类型的证书时,域名数量取值范围为“2~100”

order_number

Integer

购买的证书数量。取值范围为1~1000。

agree_privacy_protection

Boolean

是否同意隐私协议。

  • true:同意隐私协议。
  • false:不同意隐私协议。

此处仅能设置为true才能成功购买证书。

响应消息

响应参数

参数

是否必选

参数类型

描述

order_id

String

订单号。

cert

Array of cert objects

证书列表,详情请参见表1

表1 cert

参数

是否必选

参数类型

描述

cert_id

String

证书ID。

示例

如下以购买1张品牌为Globalsign,域名类型为多域名,域名数量为5,有效期为1年的OV证书为例。

  • 请求样例
    { 
     "cert_brand":"GLOBALSIGN", 
     "cert_type":"OV_SSL_CERT ", 
     "domain_type":"MULTI_DOMAIN", 
     "effective_time": 1, 
     "domain_numbers": 5, 
     "order_number": 1, 
     "agree_privacy_protection":true, 
     }
  • 响应样例
    {  
    "order_id": "CS1803192259ROA8U" 
    "cert": [{ 
             "cert_id": "scs1481110651012", 
           }] 
    }

    { 
       "error_code": "SCM.XXXX",  
       "error_msg": "XXXX"   
     }

状态码

表2描述的是API返回的正常状态码。
表2 状态码

状态码

编码

状态说明

200

OK

请求已成功。

异常状态码,请参见错误码