此 API 允許使用者上傳一個檔案,Goodjudge 將進行病毒掃描,以確認檔案是否含有病毒。
curl -X POST https://goodjudge.104cloud.info/scan/file -H 'api-token: ida_xxx' -F 'file=@your-file.txt'
重要輸入參數
- content-type (HTTP Header)
- 必須為 multipart/form-data 編碼格式。
- api-token (HTTP Header)
- 登入所需使用的 API TOKEN,如無此資料請向維運人員申請。
- file (Form Field)
- 需掃描的檔案。
輸出樣本
{
"malicious": false
}
重要輸出參數
- malicious
-
真假值,說明是否有在上傳檔案掃描過程中發現病毒。
-
true: 表示掃描過程中偵測到病毒,建議進行阻擋處理。
-
false: 表示掃描過程中未偵測到病毒,可能的情況包括:檔案本身不是病毒、掃描工作逾時、檔案過大導致無法掃描。
限制
-
最大檔案上傳限制為 100 MB。超過此限制將回傳
413 Payload Too Large。
-
請求處理時間最長為 30 秒。若超過時間限制,掃描將被中止,並回傳
malicious: false。
其他提醒
- 請務必依說明使用,否則無法保證 API 跨版本穩定性。