檢視次數:
此主題描述 ICAP 服務返回的狀態碼和回應訊息。

狀態碼防護總覽

ICAP 狀態
HTTP 狀態
說明
回應訊息
200 OK
無
ICAP 功能協商
無
204 無修改
無
檔案乾淨，無需修改
無
200 OK
400 錯誤請求
請求資料無效或遺失
請參閱以下詳細資訊
200 OK
401 未經授權
驗證失敗
因驗證錯誤而異
200 OK
403 禁止
檔案中偵測到惡意程式
偵測到病毒
405 不允許方法
無
不支援的 ICAP 方法
無
200 OK
500 內部伺服器錯誤
掃瞄錯誤或系統錯誤
請參閱以下詳細資訊

成功回應

200 OK (OPTIONS)
標準 ICAP 握手回應。客戶端接收伺服器功能，包括支援的方法和預覽大小。
204 No modifications
檔案掃瞄成功完成，未檢測到惡意程式。原始檔案未經修改地通過。

用戶端錯誤回應

400 錯誤請求
請求缺少執行掃瞄所需的資料防護。
訊息
說明
無法從標頭或 URL 判斷 FileName
無法從X-scan-file-name標頭或請求 URL 中確定 FileName。
回應主體為空
請求不包含可供掃瞄的回應主體。
401 Unauthorized
驗證或授權檢查失敗。回應訊息會根據具體的驗證錯誤而有所不同。
403 Forbidden
在掃描的檔案中檢測到惡意程式。
訊息
說明
偵測到病毒
掃瞄引擎在檔案中偵測到惡意內容。原始檔案已封鎖。
405 Method not allowed
不支援 ICAP 方法。僅支援 OPTIONS 和 RESPMOD 方法。

伺服器錯誤回應

500 Internal server error
伺服器錯誤分為兩種類型：
  • 掃瞄錯誤（與檔案相關）
  • 系統錯誤
Scan errors (file-related)
當掃瞄引擎無法處理檔案時，會發生這些錯誤。
錯誤碼
訊息
說明
-69
壓縮檔中的檔案過多。(-69)
壓縮檔中的檔案總數超過限制。
-71
超過最大壓縮比。(-71)
壓縮比超過限制。
-76
檔案過大，無法提取。(-76)
解壓縮後的檔案大小超過限制。
-78
壓縮層數過多 (-78)
壓縮檔中的總層數超過限制。
-92
無法掃瞄受密碼保護的檔案。(-92)
該檔案已受密碼保護，無法進行掃描。
其他
內部掃瞄錯誤 ({code})
發生未指定的掃瞄錯誤。
Response format
回應包含特定的錯誤描述和錯誤碼：
{description}（{error_code}）
Example responses
Cannot scan password protected files. (-92)
Cannot scan password protected files. (-92); File is too large to extract. (-76)

系統錯誤

這些錯誤是由於內部系統問題引起的，與檔案內容無關。
訊息
說明
內部伺服器錯誤
系統或基礎設施發生錯誤。請重試請求。如果問題持續，請聯絡技術支援中心。
Response format
所有錯誤回應均以 HTML 格式返回：
<html><body><h1>{error_message}</h1></body></html>
HTTP 回應包括：
  • Content-Type: text/html; charset=utf-8
  • 內容長度：{size}