跳至主要内容

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 請聯絡 Racent 技術支援
productCodeStringY產品編碼，取得產品編碼（見 2.7）
yearsIntY購買年限（目前僅支援 1、2、3、4、5），依據具體產品而定。
refIdStringN客戶提供的唯一客戶訂單號
verificationPicFileN備用驗證材料。用於組織驗證，支援 .jpg/.jpeg/.png/.gif/.bmp/.rar/.zip/.pdf 格式，內容大小不超過 2M。
domainVerificationPicFileN當網域驗證方式為：VERIFY_DOCUMENT，此項為 Y。用於網域控制權驗證（DCV）（目前僅支援 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"
}

最後於 更新