此 API 允許使用者上傳一段純文字，Goodjudge 會擷取其中 HTTP 與 HTTPS 的連結，並透過 HTTP GET 下載這些連結指向的檔案，並將其送入掃毒核心進行分析，以判斷檔案中是否存在病毒。
curl -X POST https://goodjudge.104cloud.info/scan/text -H 'api-token: ida_xxx' --data-urlencode 'text=Hello https://secure.eicar.org/eicar.com.txt, World'
重要輸入參數
- content-type (HTTP Header)
- 必須為 application/x-www-form-urlencoded 編碼格式。
- api-token (HTTP Header)
- 登入所需使用的 API TOKEN，如無此資料請向維運人員申請。
- text (Form Field)
- 需掃描的純文字。
輸出樣本
{
"malicious": true,
"malicious_urls": [
"https://secure.eicar.org/eicar.com.txt"
]
}
重要輸出參數
- malicious
-
真假值，說明是否有在任一下載的檔案中發現病毒。
-
true: 表示掃描過程中偵測到病毒，建議進行阻擋處理。
-
false: 表示掃描過程中未偵測到病毒，可能的情況包括：文字中不包含有病毒的連結、或是有病毒的連結無法被分析處理（另見下方「限制」的說明）
- malicious_urls
- 文字陣列，說明上傳的字串中，哪些連結包含病毒。
限制
-
此 API 無法用來偵測釣魚與挖礦連結。
-
出於效能考量，一個文字塊中，最大探測連結數量為 20 個。如果文字塊中發現的連結數超過上限，則僅掃描最先出現的 20 個，其餘將忽略。
-
單一連結最大檔案下載限制為 100 MB。如果連結檔案大小超過限制，相應的連結會被忽略。
-
請求處理時間最長為 30 秒。如果超時且仍有部分下載或掃描仍未完成，未完成的連結會被忽略。
其他提醒
- 請務必依說明使用，否則無法保證 API 跨版本穩定性。