1.下订单

https://api.certum.cn/certificates/id/:pNo   [post]

请求参数:

请求头:

apiKey 类型 string

请求体:

(1)非flex产品请求参数:单域名和通配符参数

{
    "year": 1, 
    "dcvMethod": "dns", 
    "csr": "csr", 
    "contactInfo": {
        "lastname": "star", 
        "firstname": "moon", 
        "position": "it", 
        "email": "[email protected]", 
        "telephone": "123546"
    }, 
    "notifyUrl":"https://test.com/notify",
    "orgInfo": {
        "orgName": "", 
        "creditCode": "X869112948", 
        "country": "CN", 
        "province": "sichuan", 
        "locality": "chengdu", 
        "address": "赤色要塞", 
        "postalCode": "610000", 
        "telephone": "18884315616", 
        "joiCountry": "CN", 
        "joiProvince": "湖南", 
        "joiLocality": "长沙", 
        "registryAddr": "世界之窗", 
        "dateOfIncorporation": "2010-03-12"
    }
}

(2)flex产品请求参数:

{
    "year": 1, 
    "dcvMethod": "dns", 
    "csr": "csr", 
    "domainNames": "1.certum.cn,*.certum.com.cn", 
    "contactInfo": {
        "lastname": "star", 
        "firstname": "moon", 
        "position": "it", 
        "email": "[email protected]", 
        "telephone": "123546"
    }, 
    "notifyUrl":"https://test.com/testPush",
    "orgInfo": {
        "orgName": "", 
        "creditCode": "X869112948", 
        "country": "CN", 
        "province": "hunan", 
        "locality": "changsha", 
        "address": "岳麓", 
        "postalCode": "410000", 
        "telephone": "123456", 
        "joiCountry": "CN", 
        "joiProvince": "湖南", 
        "joiLocality": "长沙", 
        "registryAddr": "岳麓", 
        "dateOfIncorporation": "2010-03-12"
    }
}

下订单注意:

1.所有ev证书(增强级)不支持ip和通配, 产品列表里 只有ov(企业级)支持ip 2.所有品牌的包含通配域名的证书都不再支持文件验证。比如 非flex通配符证书 以及flex的证书中含有通配域名都不支持文件验证

响应数据:

{
    "code": 200, 
    "msg": "ok", 
    "data": {
        "certID": 142932802604630016,
        "cost": 123456,
        "orderNo": "20201232020789"
    }
}

请求参数解释

参数名称
Req/Opt
类型
描述

year

optional

int

1.免费证书不需要此参数 2.申请几年的证书;仅支持1年的有(globalsign,alphassl),仅支持1-5年的有(sectigo,positivessl),支持1-6年的有(geotrust,rapidssl,digicert,securesite,thawte,securesitechina,geotrustchina)

dcvMethod

required

string

域名验证方式;仅支持三种:file文件验证,dns验证,email邮件验证,globalsign和alphassl不支持邮件验证

csr

required

string

csr 提示:csr如果粘贴在json中后有格式错误,可以把csr的换行都换成\n,若ECC算法,仅支持P256,P384; 某些品牌不支持ECC算法

domainNames

optional

string

用逗号连接的域名字符串,没有子域名可不写,不包含主域名,主域名会默认取csr里的

contactInfo

required

object

联系人信息 SSL证书必需

..lastname

required

string

..firstname

required

string

..position

required

string

职位

..email

required

string

邮箱

..telephone

required

string

电话

notifyUrl

optional

string

通知回调地址

orgInfo

optional

object

公司信息,ov/ev SSL证书必需

..orgName

required

string

公司名称

..creditCode

required

string

社会信用代码

..country

required

string

国家

..province

required

string

省份或州

..locality

required

string

城市

..address

required

string

地址

..postalCode

required

string

邮编

..telephone

required

string

手机号

..joiCountry

required

string

注册国家

..joiProvince

required

string

注册省份或州

..joiLocality

required

string

注册城市

..registryAddr

required

string

注册地址

..dateOfIncorporation

required

string

注册日期 ,格式必须为 yyyy-mm-dd 如:2006-01-02

响应参数解释

参数名称
类型
描述

code

int

状态码,200; 500及其他错误码

msg

string

错误或成功信息提示

data

object

返回信息描述的对象

..certID

int

证书编号(重签的证书的编号一定大于重签之前的证书编号)

..cost

int

订单金额(分)

..orderNo

string

订单编号

Last updated