证书下单 - Probill 经销商接口

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Query 参数

id

integer

服务器ID

可选

默认值:

3624

Body 参数application/json

productId

string

证书产品编号

必需

可通过产品价格表获取

year

integer

购买年限

可选

默认1年

valid

string

验证方式

必需

通过产品价格表查询支持的验证方式

commonName

string

通用名称

必需

通配符必须以 *. 开头

domains

string

附加域名

可选

英文逗号分隔多个域名

origin

string | null

CSR来源

可选

留空默认自动创建；txt=上传csr文本（需自行记录CSR秘钥）

autoCsr

string

自动生成CSR

可选

0=默认自动生成CSR，1=手动设置CSR参数

encryption

string

加密算法

可选

可选值:rsa/ecc，通过产品价格表查询支持的选项

keyCurve

string

ECC密钥曲线

可选

仅当encryption为ECC时必传可选值:p256/p384/p512)，通过产品价格表查询支持的选项

keySize

string

加密位数

可选

仅当encryption为RSA时必传可选值:（2048/3072/4096）

hashSign

string

签名算法

可选

可选值：SHA256/SHA384/SHA512

csrTxt

string | null

CSR文本

可选

origin=txt时，该参数必填

contact

object

联系人信息

可选

ov/ev SSL证书必需

lastname

string

姓氏

必需

firstname

string

名称

必需

position

string

职位

必需

email

string

邮箱

必需

telephone

string

电话

必需

company

object

公司信息

可选

ov/ev SSL证书必需

orgName

string

公司名称

必需

creditCode

string

社会信用代码

必需

country

string

国家码

必需

ISO3166国家码

province

string

省份或州

必需

locality

string

城市

必需

address

string

地址

必需

postalCode

string

邮编

必需

telephone

string

电话

必需

示例

{
    "productId": "11",
    "year": 1,
    "valid": "dns_txt",
    "commonName": "domain.com",
    "domains": "domain1.com,domain2.com",
    "origin": null,
    "autoCsr": "1",
    "encryption": "rsa",
    "keyCurve": "p384",
    "keySize": "2048",
    "hashSign": "sha256",
    "csrTxt": null,
    "contact": {
        "lastname": "han",
        "firstname": "meimei",
        "position": "it",
        "email": "test@test.com",
        "telephone": "1234567890"
    },
    "company": {
        "orgName": "Probill",
        "creditCode": "1111111",
        "country": "CN",
        "province": "FUJIAN",
        "locality": "XIAMEN",
        "address": "XIAMEN",
        "postalCode": "100000",
        "telephone": "1234567890"
    }
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'http://probill.local/api/ssl/create?id=3624' \
--header 'Content-Type: application/json' \
--data-raw '{
    "productId": "11",
    "year": 1,
    "valid": "dns_txt",
    "commonName": "domain.com",
    "domains": "domain1.com,domain2.com",
    "origin": null,
    "autoCsr": "1",
    "encryption": "rsa",
    "keyCurve": "p384",
    "keySize": "2048",
    "hashSign": "sha256",
    "csrTxt": null,
    "contact": {
        "lastname": "han",
        "firstname": "meimei",
        "position": "it",
        "email": "test@test.com",
        "telephone": "1234567890"
    },
    "company": {
        "orgName": "Probill",
        "creditCode": "1111111",
        "country": "CN",
        "province": "FUJIAN",
        "locality": "XIAMEN",
        "address": "XIAMEN",
        "postalCode": "100000",
        "telephone": "1234567890"
    }
}'

返回响应

🟢200成功

application/json

Body

code

integer

可选

状态码：0为成功，大于0为异常

msg

string

错误或成功信息提示

可选

time

integer

接口执行时间

可选

data

object

响应数据集

可选

sslNo

string

证书编号

可选

cost

string

订单金额

可选

csr

string

CSR

可选

key

string

证书秘钥

可选

unitCurrency

string

货币单位（前缀）

可选

unitMoney

string

货币单位（后缀）

可选

示例

成功示例异常示例

{
    "msg": "",
    "code": 0,
    "time": 1722421258,
    "data": {
        "sslNo": "202404220916254360",
        "csr": "",
        "key": "",
        "cost": "100.00",
        "unitCurrency": "$",
        "unitMoney": "USD"
    }
}