Goodjudge 檔案掃毒服務

Scan URI API 說明

此 API 允許使用者上傳一個連結，Goodjudge 會透過 HTTP GET 方式擷取該連結指向的檔案，並將其送入掃毒核心進行分析，以判斷檔案中是否存在病毒。

cURL 操作範例

curl -X POST https://goodjudge.104cloud.info/scan/uri -H 'api-token: ida_xxx' --data-urlencode 'uri=https://secure.eicar.org/eicar.com.txt'

重要輸入參數

content-type (HTTP Header)
必須為 application/x-www-form-urlencoded 編碼格式。
api-token (HTTP Header)
登入所需使用的 API TOKEN，如無此資料請向維運人員申請。
uri (Form Field)
需掃描的連結。

輸出樣本

{
  "malicious": true
}

重要輸出參數

malicious
真假值，說明是否有在下載的檔案掃描過程中發現病毒。
  • true: 表示掃描過程中偵測到病毒，建議進行阻擋處理。
  • false: 表示掃描過程中未偵測到病毒，可能的情況包括：檔案本身不是病毒、掃描工作逾時、檔案過大導致無法掃描、無法下載遠端檔案。

限制

  1. 此 API 無法用來偵測釣魚與挖礦連結。
  2. 單一連結最大檔案下載限制為 100 MB。如果目標連結檔案大小超過限制會中斷掃描，回傳 malicious: false。
  3. 請求處理時間最長為 30 秒。若超過時間限制，掃描將被中止，並回傳 malicious: false。

其他提醒

  1. 請務必依說明使用，否則無法保證 API 跨版本穩定性。