跳到主要内容
版本:Next Version

2.1 验证数据

2.1.1 接口说明

测试环境
真实环境https://portal.racent.com/ssl/validate
请求方式POST
content-typemultipart/form-data
描述此接口用于验证您传递的所有订购数据。请您在调用订购接口之前调用该接口,以确保处理订单顺利。此验证用于确认您的账户信息,以及确保您的订购信息无误,返回相关的错误代码(见附录3.1)。

2.1.2 参数定义

参数名称参数类型必填说明
api_tokenStringY用户token,获取token请联系锐成技术支持
productCodeStringY产品编码,获取产品编码(见2.7)
yearsIntY购买年限(目前只支持1,2,3,4,5),根据具体产品而定。
refIdStringN客户提供的唯一客户订单号
verificationPicFileN备用验证材料。用于组织验证,支持 .jpg/.jpeg/.png/.gif/.bmp/.rar/.zip/.pdf格式,内容不超过2M。
domainVerificationPicFileN当域名验证方式为:VERIFY_DOCUMENT,此项为Y。用于域名所有权验证(目前仅支持CFCA)。
paramsStringY订购信息(json字符串),具体描述如下
csrStringN当参数为空时,会为你生成csr,并保存私钥。
privateKeyStringN私钥。
serverStringN服务器。仅与SSL证书相关。SSL证书参数为Y,其他类型产品参数为N。若不需要此参数,请默认“other”。
uniqueValueStringN仅与Sectigo产品相关。1-20个字符(a-z A-Z 0-9)用于分销商自主生成验证值。
dcvMethodStringN统一设置申请域名验证方式。
必须为以下四种方式之一:
EMAIL(邮箱验证)
HTTP_CSR_HASH(文件验证)
CNAME_CSR_HASH(DNS验证)
HTTPS_CSR_HASH(https文件验证)
VERIFY_DOCUMENT(域名证书证明,仅支持CFCA)
CFCA该项为Y
domainInfoStringN域名信息,仅与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"
}
]
具体描述如下:
dcvMethodStringN域名验证方式。
必须为以下四种方式之一:
EMAIL(邮箱验证)
HTTP_CSR_HASH(文件验证)
CNAME_CSR_HASH(DNS验证)
HTTPS_CSR_HASH(https文件验证)
当上级dcvMethod不存在时,此项为Y。
当上级dcvMethod存在,该项也存在,会优先使用上级dcvMethod。
dcvEmailStringN域名验证邮箱。
该项为N时,缺省情况如下
racent.com : admin@racent.com
www.racent.com : admin@racent.com
*.racent.com : admin@racent.com
domainNameStringN域名
organizationInfoStringN公司信息。当订购需企业验证类产品,此参数为Y。示例如下:
{
"organizationCity": "上海",
"organizationName": "某公司",
"organizationMobile": "18111111111",
"organizationAddress": "上海市路",
"organizationCountry": "CN",
"organizationPostCode": "401320"
}"
organizationCityStringN公司所在城市。
organizationNameStringN公司名称。
organizationMobileStringN公司电话。
organizationAddressStringN公司地址。
organizationCountryStringN公司所在国家( ISO 3166-1标准中的 双字母代码)。
organizationPostCodeStringN公司所在地邮编。
organizationRegNumberStringN公司证件号码。CFCA此项为Y。
idTypeStringN公司证件类型。CFCA此项为Y。
值如下:
TYDMZ:统一社会信用代码
OTHERS:其他
AdministratorstringY管理员信息、联系人。当申请代码签名、邮件签名、文档签名时,此参数作为申请信息。另外如csr为N,该信息作为csr的生成信息。
{
"job": "总经办",
"city": "上海市",
"email": "xx@yy.com",
"state": "上海市",
"mobile": "18111111111",
"address": "上海市",
"country": "CN",
"lastName": "zhang",
"postCode": "401320",
"firstName": "nick",
"organation": "某公司"
}"
jobStringY管理员职位。
cityStringY管理员所在城市。
emailStringY管理员的邮箱。
stateStringY管理员所在省或州。
mobileStringY管理员联系方式。
addressStringY管理员联系地址。
countryStringY管理员所在国家( ISO 3166-1标准中的 双字母代码)。
lastNameStringY管理员姓。
postCodeStringY管理员所在地邮编。
firstNameStringY管理员名字。
organationStringY管理员公司名称。
idTypeStringN证件类型。CFCA此项为Y。
值如下:
SFZ:身份证
HZ:护照
idNumberStringN证件号码。CFCA此项为Y。
financestring仅与SSL证书相关。
财务人员信息。可以与管理员信息一致。当订购产品非dv类型时,此参数为Y。
{
"job": "财务部",
"city": "上海市",
"email": "xx@yy.com",
"state": "上海市",
"mobile": "18111111111",
"address": "上海市",
"country": "CN",
"lastName": "zhang",
"postCode": "401320",
"firstName": "nick",
"organation": "某公司"
}"
jobStringN财务员职位。
cityStringN财务员所在城市。
emailStringN财务员的邮箱。
stateStringN财务员所在省或州。
mobileStringN财务员联系方式。
addressStringN财务员联系地址。
countryStringN财务员所在国家( ISO 3166-1标准中的 双字母代码)。
lastNameStringN财务员姓。
postCodeStringN财务员所在地邮编。
firstNameStringN财务员名字。
organationStringN财务员所在公司。
idTypeStringN证件类型。CFCA此项为Y。
值如下:
SFZ:身份证
HZ:护照
idNumberStringN证件号码。CFCA此项为Y。
techstringN仅与SSL证书相关。
技术员信息。当订购产品非dv类型时,此参数为Y。
{
"job": "技术部","city": "上海市",
"email": "xx@yy.com",
"state": "上海市",
"mobile": "18111111111",
"address": "上海市",
"country": "CN",
"lastName": "zhang",
"postCode": "401320",
"firstName": "nick",
"organation": "某公司"
}"
jobStringN技术员职位。
cityStringN技术员所在城市。
emailStringN技术员的邮箱。
stateStringN技术员所在省或州。
mobileStringN技术员联系方式。
addressStringN技术员联系地址。
countryStringN技术员所在国家( ISO 3166-1标准中的 双字母代码)。
lastNameStringN技术员姓。
postCodeStringN技术员所在地邮编。
firstNameStringN技术员名字。
organationStringN技术员所在公司。
idTypeStringN证件类型。CFCA此项为Y。
值如下:
SFZ:身份证
HZ:护照
idNumberStringN证件号码。CFCA此项为Y。

函数返回

参数名称参数类型必填说明
codeIntY返回状态,具体详解请参见附录3.1
errorsObject or StringN当返回状态为错误时,错误信息。

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"
}