2.21 修改申請資料

2.21.1 API 資訊

測試環境
真實環境	https://portal.racent.com/ssl/alter
請求方式	POST
content-type	multipart/form-data
描述	此介面僅用於 CFCA 證書申請失敗時，修改申請資料。

2.21.2 參數定義

參數名稱	參數類型	必填	說明
api_token	String	Y	身分憑證，生成 token 請聯絡 Racent 技術支援。
certId	String	Y	Racent 證書 id
refId	String	N	客戶提供的唯一客戶訂單號
verificationPic	File	N	備用驗證材料。用於組織驗證，支援 .jpg/.jpeg/.png/.gif/.bmp/.rar/.zip 格式，內容大小不超過 2M。
domainVerificationPic	File	N	當網域驗證方式為：VERIFY_DOCUMENT 時，此項為 Y。用於網域控制權驗證（DCV）（目前僅支援 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。
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。 值如下： 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	財務人員所在城市。
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實例唯一憑據。
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	檔案驗證檔案路徑
failReason	Object	N	當 Racent 向憑證授權單位（CA）申請證書失敗，且能明確失敗原因時，會返回此項。
dataReasons	Array	N	資料原因
key	String	N	項目
reason	String	N	原因
sysReason	String	N	系統原因