2.3 獲取證書申請狀態

2.3.1 Api 資訊

測試環境
正式環境	https://portal.racent.com/ssl/collect
請求方式	POST
content-type	multipart/form-data
描述	此介面用於取得訂購憑證狀態、取得憑證、取得驗證資訊。

2.3.2 參數定義

參數名稱	參數類型	必填	說明
certId	String	Y	racent 憑證 id
api_token	String	Y	身分憑據，產生 token 請聯絡 Racent 技術支援。

函式回傳

參數名稱	參數類型	必填	說明
code	int	Y	回傳狀態，具體詳解請參見附錄 3.1
status	String	Y	訂單狀態： PENDING:申請中 COMPLETE:申請成功 CANCELLED:已取消 REISSUED:已重簽 FAILED:申請失敗 RENEWED:已續費 REVOKED:已撤銷
certStatus	String	Y	憑證狀態： PENDING:申請中 COMPLETE:申請成功 CANCELLED:已取消 REISSUED:已重簽 FAILED:申請失敗 RENEWED:已續費 REVOKED:已撤銷
data	Object	N	回傳資料，以下為具體詳情
failReason	Object	N	當狀態為FAILED時，該參數為Y，失敗原因
dataReasons	Array	N	資料原因
key	String	N	項目
reason	String	N	原因
sysReason	String	N	系統原因
beginDate	String	N	當狀態為COMPLETE時，該參數為Y，憑證開始時間
endDate	String	N	當狀態為COMPLETE時，該參數為Y，憑證結束時間
certificate	String	N	當狀態為COMPLETE時，該參數為Y，pem憑證
caCertificate	String	N	當狀態為 COMPLETE 時，該參數為 Y，pem 中繼憑證
jks	String	N	當狀態為 COMPLETE 時，且 Racent 有正確的私鑰資訊，該參數為 Y，jks 憑證內容的 base64 編碼。
jksPass	String	N	當狀態為 COMPLETE 時，且 Racent 有正確的私鑰資訊，該參數為 Y，jks 的憑證密碼。
pkcs12	String	N	當狀態為 COMPLETE 時，且 Racent 有正確的私鑰資訊，該參數為 Y，PKCS12 憑證內容的 base64 編碼。
pkcsPass	String	N	當狀態為 COMPLETE 時，且 Racent 有正確的私鑰資訊，該參數為 Y，PKCS12 的憑證密碼。
privateKey	String	N	當狀態為 COMPLETE 時，且 Racent 有正確的私鑰資訊，該參數為 Y，私鑰資訊
rsaPrivateKey	String	N	rsa 格式私鑰，當狀態為 COMPLETE 時，且 Racent 有正確的私鑰資訊，該參數為 Y，私鑰資訊
replaceCertId	String	N	當狀態為 REISSUED 時，該參數為 Y， 重新簽發後的 Racent 憑證 id
oldCertId	String	N	當申請的憑證為重新簽發憑證時，該參數為 Y, 舊的 Racent 憑證 id
vendorId	String	N	CA 訂單號
vendorCertId	String	N	CA 證書號（sectigo 訂單號）
DCVfileName	String	N	網域檔案驗證，檔案名稱
DCVfileContent	String	N	檔案驗證，檔案內容
DCVdnsHost	String	N	DNS 驗證，host
DCVdnsValue	String	N	DNS 驗證 value
DCVdnsType	String	N	DNS 驗證 type
dcvInfo	Object	N	申請證書中的每個網域驗證值不同時，此項為 Y 每項類型為 Object，每項物件名為申請的網域，例如：racent.com。每項詳情如下：
DCVfileName	String	N	網域檔案驗證，檔案名稱
DCVfileContent	String	N	檔案驗證，檔案內容
DCVdnsHost	String	N	DNS 驗證，host
DCVdnsValue	String	N	DNS 驗證 value
DCVdnsType	String	N	DNS 驗證 type
DCVfilePath	String	N	檔案驗證檔案路徑
dcvList	Array	N	網域控制權驗證（DCV）清單，每項類型為 Object，每項詳情如下:
domainName	String	N	網域名稱
dcvMethod	String	N	網域控制權驗證（DCV）方法
dcvEmail	String	N	網域控制權驗證（DCV）信箱
is_verify	String	N	已驗證參數值為「verified」，未驗證無此參數
application	Object	N	提交訂單狀態
status	String	N	參數為以下值之一： notdone:未完成 done：已完成 ongoing:進行中
dcv	Object	N	網域驗證狀態
status	String	N	參數為以下值之一： notdone:未完成 done：已完成 ongoing:進行中
ov	Object	N	組織驗證狀態
status	String	N	參數為以下值之一： notdone:未完成 done：已完成 ongoing:進行中
issued	Object	N	頒發狀態
status	String	N	參數為以下值之一： notdone:未完成 done：已完成 ongoing:進行中
applyParams	Object	N	申請參數，具體請參考申請介面（place）請求參數
csr	String	N	csr
Administrator	Object	N	管理員資訊
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	Object	N	技術員資訊，具體項目和管理員資訊一致
finance	Object	N	財務人員資訊，具體項目和管理員資訊一致
organizationInfo	Object	N	公司資訊
organizationCity	String	N	城市
organizationName	String	N	名稱
organizationMobile	String	N	電話
organizationAddress	String	N	地址
organizationCountry	String	N	國家
organizationPostCode	String	N	郵遞區號
organizationRegNumbe	String	N	公司證件號碼。CFCA此項為Y。
idType	String	N	公司證件類型。CFCA此項為Y。 值如下： TYDMZ：統一社會信用代碼 OTHERS：其他
errors	Object or String	N	當回傳狀態為錯誤時，顯示具體錯誤資訊。