业务说明和提示
下单：此操作将数据提供给接口提供方，然后进行下单。DV与EV、OV申请信息是不一致的，DV不需要提供公司信息。EV与OV申请是一致的。
|
API_FUNCTION_NAME
|
构造后的API Endpoint
|
|---|---|
| placeOrder | https://mall.okcert.cn/jeecg/okcertController.do?placeOrder |
业务参数
| 参数名称 | 类型 | 字符长度 | 是否必填 | 数据说明及要求 | 数据举例 | |
|---|---|---|---|---|---|---|
| token | String | / | 必填 | 必须是由getToken返回的结果。 | / | |
| data | 基础信息 | |||||
| certType | String | 2 | 必填 | 证书类型：必须是由证书类型列表里所提供的类型编码。 | 003 | |
| commonName | String | 64 | 必填 | 证书通用名。 | www.okcert.cn | |
| country | String | 2 | 必填 | 国家：英文字符编码。 | CN | |
| state | String | 128 | 必填 | 省份。 | 广东 | |
| locality | String | 32 | 必填 | 城市。 | 广州 | |
| applyYears | Integer | 1 | 必填 | 申请年限：域名申请年限1年或2年。 | 1 | |
| csr | String | 4000 | 必填 | CSR：合规，有效的，必须和你填写的证书通用名（commonName），机构名称(organization)，部门(organizationalUnit)，国家(country)，省份(state)，城市(locality)信息保持一致。 | -----BEGIN CERTIFICATE REQUEST----- ******** -----END CERTIFICATE REQUEST----- |
|
| 域名信息 | ||||||
| dnsName | String | 255 | 必填 | 域名：多个域名用”,”间隔，域名必须是符合规定的。 | www.baidu.com,www.okcert.com | |
| approveMethod | String | / | 必填 | 验证方式有两种：DNS/FILE，选其中一种。 | DNS/FILE | |
| 公司信息 | ||||||
| organization | String | 64 | 必填(EV、OV) | 公司名称。 | 广东金网信息科技有限公司 | |
| orgNum | String | 255 | 必填(EV、OV) | 社会统一信用代码。 | MOD13U4HFIWUR3453534546 | |
| companyPhone | String | 255 | 必填(EV、OV) | 公司联系号码(座机或手机号)合规、有效的。 | 12345435435 | |
| 申请人信息 | ||||||
| applicantDepartment | String | 64 | 必填(EV、OV) | 申请人所在部门。 | 技术部 | |
| applicantName | String | 255 | 必填 | 申请人姓名。 | 张三 | |
| applicantEmail | String | 255 | 必填 | 书申请人邮箱：格式正确的,合法的，有效的电子邮箱地址。 | 123456@qq.com | |
| applicantPhone | String | 255 | 必填 | 申请人电话：有效的。 | 12567890988 | |
响应参数
| 参数 | 类型 | 描述 | 示例 | ||
|---|---|---|---|---|---|
| msg | String | 返回携带的提示信息。 | 下单成功 | ||
| code | String | 当正确时，返回的为0, 其他参数代表具体含义，详见码表。 | 0 | ||
| data | 参数 | 类型 | 描述 | 示例 | |
| orderId | String | 订单ID。 | 402880026cd83479016cd83bdfeb0002 | ||
| approverlist(List集合：与申请的域名相对应。) | 参数 | 类型 | 描述 | 示例 | |
| approveMethod | String | 验证方式有两种：DNS/FILE，选其中一种。 | DNS | ||
| code | String | 记录值。 | ef16bce354bb03d1c2b35d838a0c56a7f1d17ca1a66ab483a958825241900b6d | ||
| fqdn | String | 全限定域名。 | okcert.cn | ||
成功响应
成功响应
{
"code"
:
"0"
,
"data"
:
{
"approverlist"
:
[{
"approveMethod"
:
"DNS"
,
"code"
:
"ef16bce354bb03d1c2b35d838a0c56a7f1d17ca1a66ab483a958825241900b6d"
,
"fqdn"
:
"okcert.cn"
}],
"orderId"
:
"402880f46f59842d016f59b889c10003"
},
"msg"
:
"下单成功"
}
|
失败响应
失败响应
{
"code"
:
"1"
,
"data"
:
"null"
,
"msg"
:
"下单失败"
}
|