2.2 订购证书

2.2.1 接口说明

测试环境
真实环境	https://portal.racent.com/ssl/place
请求方式	POST
content-type	multipart/form-data
描述	此接口用于订购证书。

2.2.2 参数定义

参数名称	参数类型	必填	说明
api_token	String	Y	身份凭据，生成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	订购信息，具体描述如下
csr	String	N	当参数为空时，会为你生成csr，并保存私钥。
privateKey	String	N	私钥。
server	String	N	服务器。仅与SSL证书相关。SSL证书参数为Y，其他类型产品参数为N。若不需要此参数，请默认“other”。
orgCheck	Int	N	值为0或1。当值为1时，将根据你提交的组织信息检索你账号下的所有组织，如果存在则使用存在组织的关联信息，如果不存在我们将其保存为新的组织。当值为0时，不保存组织信息。
duplicateOrgCheck	Int	N	值为0或1。该参数目前仅与Digicert SSL证书相关。用于判断是否复用之前验证通过的组织和域名信息。当值为1时，复用。当值为0时，新建。默认为1。
needFree	Int	N	值为1或2。当值为1时，将赠送FQDN，同时www.<domain>也将赠送domain。值为2时，不赠送
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	公司所在地邮编。
organizationRegNumbe	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	管理员所在城市。
email	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。
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	财务员所在城市。
email	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	技术员所在城市。
email	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	当返回状态为错误时，具体错误信息。
data	Object	N	当返回状态为成功时，此参数为Y。具体描述如下：
certId	String	N	racent证书id。请妥善保管，此参数为racent实例唯一凭据。
failReason	Object	N	当锐成向CA申请证书失败，并能明确了失败原因，会返回此项。
dataReasons	Array	N	数据原因
key	String	N	项目
reason	String	N	原因
sysReason	String	N	系统原因
vendorId	String	N	CA订单号。
vendorCertId	String	N	CA证书号。
DCVfileName	String	N	文件验证文件名
DCVfileContent	String	N	文件验证文件内容
DCVdnsHost	String	N	Dns验证主机值
DCVdnsValue	String	N	Dns验证记录值
DCVdnsType	String	N	Dns验证记录类型
DCVfilePath	String	N	文件验证文件路径
dcvInfo	Object	N	申请证书中的每个域名验证值不一样时，此项为Y 每项类型为Object，每项对象名为申请得域名，如:racent.com。每项详情如下：
DCVfileName	String	N	文件验证文件内容
DCVfileContent	String	N	文件验证文件内容
DCVdnsHost	String	N	Dns验证主机值
DCVdnsValue	String	N	Dns验证记录值
DCVdnsType	String	N	Dns验证记录类型
DCVfilePath	String	N	文件验证文件路径