2.1 验证数据
2.1.1 接口说明
测试环境 | |
---|---|
真实环境 | https://portal.racent.com/ssl/validate |
请求方式 | POST |
content-type | multipart/form-data |
描述 | 此接口用于验证您传递的所有订购数据。请您在调用订购接口之前调用该接口,以确保处理订单顺利。此验证用于确认您的账户信息,以及确保您的订购信息无误,返回相关的错误代码(见附录3.1)。 |
2.1.2 参数定义
参数名称 | 参数类型 | 必填 | 说明 |
---|---|---|---|
api_token | String | Y | 用户token,获取token请联系锐成技术支持 |
productCode | String | Y | 产品编码,获取产品编码(见2.7) |
years | Int | Y | 购买年限(目前只支持1,2,3,4,5),根据具体产品而定。 |
refId | String | N | 客户提供的唯一客户订单号 |
verificationPic | File | N | 备用验证材料。用于组织验证,支持 .jpg/.jpeg/.png/.gif/.bmp/.rar/.zip/.pdf格式,内容不超过2M。 |
domainVerificationPic | File | N | 当域名验证方式为:VERIFY_DOCUMENT,此项为Y。用于域名所有权验证(目前仅支持CFCA)。 |
params | String | Y | 订购信息(json字符串),具体描述如下 |
csr | String | N | 当参数为空时,会为你生成csr,并保存私钥。 |
privateKey | String | N | 私钥。 |
server | String | N | 服务器。仅与SSL证书相关。SSL证书参数为Y,其他类型产品参数为N。若不需要此参数,请默认“other”。 |
uniqueValue | String | N | 仅与Sectigo产品相关。1-20个字符(a-z A-Z 0-9)用于分销商自主生成验证值。 |
dcvMethod | String | N | 统一设置申请域名验证方式。 必须为以下四种方式之一: EMAIL(邮箱验证) HTTP_CSR_HASH(文件验证) CNAME_CSR_HASH(DNS验证) HTTPS_CSR_HASH(https文件验证) VERIFY_DOCUMENT(域名证书证明,仅支持CFCA) CFCA该项为Y |
domainInfo | String | N | 域名信息,仅与SSL证书相关。SSL证书参数为Y,其他类型参数为N。 示例: [ { "dcvEmail": "admin@xxx.com", "dcvMethod": "EMAIL", "domainName": "www.xxx.com" }, { "dcvEmail": "admin@aaa.com", "dcvMethod": "EMAIL", "domainName": "aaa.com" }, "dcvEmail": "admin@racent.com", "dcvMethod": "EMAIL", "domainName": "racent.com" } ] 具体描述如下: |
dcvMethod | String | N | 域名验证方式。 必须为以下四种方式之一: EMAIL(邮箱验证) HTTP_CSR_HASH(文件验证) CNAME_CSR_HASH(DNS验证) HTTPS_CSR_HASH(https文件验证) 当上级dcvMethod不存在时,此项为Y。 当上级dcvMethod存在,该项也存在,会优先使用上级dcvMethod。 |
dcvEmail | String | N | 域名验证邮箱。 该项为N时,缺省情况如下 racent.com : admin@racent.com www.racent.com : admin@racent.com *.racent.com : admin@racent.com |
domainName | String | N | 域名 |
organizationInfo | String | N | 公司信息。当订购需企业验证类产品,此参数为Y。示例如下: { "organizationCity": "上海", "organizationName": "某公司", "organizationMobile": "18111111111", "organizationAddress": "上海市路", "organizationCountry": "CN", "organizationPostCode": "401320" }" |
organizationCity | String | N | 公司所在城市。 |
organizationName | String | N | 公司名称。 |
organizationMobile | String | N | 公司电话。 |
organizationAddress | String | N | 公司地址。 |
organizationCountry | String | N | 公司所在国家( ISO 3166-1标准中的 双字母代码)。 |
organizationPostCode | String | N | 公司所在地邮编。 |
organizationRegNumber | String | N | 公司证件号码。CFCA此项为Y。 |
idType | String | N | 公司证件类型。CFCA此项为Y。 值如下: TYDMZ:统一社会信用代码 OTHERS:其他 |
Administrator | string | Y | 管理员信息、联系人。当申请代码签名、邮件签名、文档签名时,此参数作为申请信息。另外如csr为N,该信息作为csr的生成信息。 { "job": "总经办", "city": "上海市", "email": "xx@yy.com", "state": "上海市", "mobile": "18111111111", "address": "上海市", "country": "CN", "lastName": "zhang", "postCode": "401320", "firstName": "nick", "organation": "某公司" }" |
job | String | Y | 管理员职位。 |
city | String | Y | 管理员所在城市。 |
String | Y | 管理员的邮箱。 | |
state | String | Y | 管理员所在省或州。 |
mobile | String | Y | 管理员联系方式。 |
address | String | Y | 管理员联系地址。 |
country | String | Y | 管理员所在国家( ISO 3166-1标准中的 双字母代码)。 |
lastName | String | Y | 管理员姓。 |
postCode | String | Y | 管理员所在地邮编。 |
firstName | String | Y | 管理员名字。 |
organation | String | Y | 管理员公司名称。 |
idType | String | N | 证件类型。CFCA此项为Y。 值如下: SFZ:身份证 HZ:护照 |
idNumber | String | N | 证件号码。CFCA此项为Y。 |
finance | string | 仅与SSL证书相关。 财务人员信息。可以与管理员信息一致。当订购产品非dv类型时,此参数为Y。 { "job": "财务部", "city": "上海市", "email": "xx@yy.com", "state": "上海市", "mobile": "18111111111", "address": "上海市", "country": "CN", "lastName": "zhang", "postCode": "401320", "firstName": "nick", "organation": "某公司" }" | |
job | String | N | 财务员职位。 |
city | String | N | 财务员所在城市。 |
String | N | 财务员的邮箱。 | |
state | String | N | 财务员所在省或州。 |
mobile | String | N | 财务员联系方式。 |
address | String | N | 财务员联系地址。 |
country | String | N | 财务员所在国家( ISO 3166-1标准中的 双字母代码)。 |
lastName | String | N | 财务员姓。 |
postCode | String | N | 财务员所在地邮编。 |
firstName | String | N | 财务员名字。 |
organation | String | N | 财务员所在公司。 |
idType | String | N | 证件类型。CFCA此项为Y。 值如下: SFZ:身份证 HZ:护照 |
idNumber | String | N | 证件号码。CFCA此项为Y。 |
tech | string | N | 仅与SSL证书相关。 技术员信息。当订购产品非dv类型时,此参数为Y。 { "job": "技术部","city": "上海市", "email": "xx@yy.com", "state": "上海市", "mobile": "18111111111", "address": "上海市", "country": "CN", "lastName": "zhang", "postCode": "401320", "firstName": "nick", "organation": "某公司" }" |
job | String | N | 技术员职位。 |
city | String | N | 技术员所在城市。 |
String | N | 技术员的邮箱。 | |
state | String | N | 技术员所在省或州。 |
mobile | String | N | 技术员联系方式。 |
address | String | N | 技术员联系地址。 |
country | String | N | 技术员所在国家( ISO 3166-1标准中的 双字母代码)。 |
lastName | String | N | 技术员姓。 |
postCode | String | N | 技术员所在地邮编。 |
firstName | String | N | 技术员名字。 |
organation | String | N | 技术员所在公司。 |
idType | String | N | 证件类型。CFCA此项为Y。 值如下: SFZ:身份证 HZ:护照 |
idNumber | String | N | 证件号码。CFCA此项为Y。 |
函数返回
参数名称 | 参数类型 | 必填 | 说明 |
---|---|---|---|
code | Int | Y | 返回状态,具体详解请参见附录3.1 |
errors | Object or String | N | 当返回状态为错误时,错误信息。 |
2.1.3 请求示例
请求示例
{
"years": 2,
"params": ‘{"server":"iis7","csr":"-----BEGIN CERTIFICATE REQUEST-----\nxxxxxxyyyoo\n-----END CERTIFICATE REQUEST-----\n","domainInfo":[{"domainName":"tt.cn","dcvMethod":"HTTP_CSR_HASH","dcvEmail":""}],"Administrator":{"organation":"cola","job":"it","firstName":"nick","lastName":"zhang","email":"xx@tt.com.cn","mobile":"13911111111","country":"CN","address":"上海市","city":"上海","state":"上海","postCode":"4457145"},"finance":{"organation":"某公司","job":"ceo","firstName":"nick","lastName":"zhang","email":"xxx@qq.com","mobile":"18111111111","country":"CN","address":"上海市","city":"上海","state":"上海","postCode":"4514154"},"tech":{"organation":"某公司","job":"ceo","firstName":"nick","lastName":"zhang","email":"xxx@qq.com","mobile":"15122222222","country":"CN","address":"上海市","city":"上海","state":"上海","postCode":"48787"},"organizationInfo":{"organizationCity":"上海","organizationState":"上海","organizationMobile":"153999999999","organizationAddress":"上海某地","organizationCountry":"CN","organizationPostCode":"200233","organizationName":"个人"}}’,
"api_token": "zzzoooppzz",
"productCode": "comodo-positivessl"
}