提交文件檢測(cè)任務(wù)后，您可以調(diào)用/green/file/results接口查詢文件檢測(cè)結(jié)果。

使用說(shuō)明

業(yè)務(wù)接口：/green/file/results，表示查詢文件檢測(cè)結(jié)果。

客戶端定時(shí)輪詢檢測(cè)結(jié)果。建議您將查詢間隔設(shè)置為30秒，最長(zhǎng)不能超過(guò)1個(gè)小時(shí)，否則結(jié)果將會(huì)丟失。

QPS限制

本接口的單用戶QPS限制為50次/秒。超過(guò)限制，API調(diào)用會(huì)被限流，這可能會(huì)影響您的業(yè)務(wù)，請(qǐng)合理調(diào)用。

請(qǐng)求參數(shù)

名稱 類型 是否必選 示例值 描述
body StringArray 是 ["file_t_6Tu1kOFV4Lw4g7dWMH4Yp1-1oB8Ci","file_image_t_5pvbNDryAe06MsUTytddIY-1oC1Db"] 要查詢的檢測(cè)任務(wù)的taskId列表。數(shù)組中的元素個(gè)數(shù)不超過(guò)100個(gè)。

您在提交檢測(cè)任務(wù)后，可以從返回?cái)?shù)據(jù)中獲取檢測(cè)任務(wù)的taskId。

返回?cái)?shù)據(jù)

名稱 類型 示例值 描述
code Integer 200 錯(cuò)誤碼，和HTTP狀態(tài)碼一致。

更多信息，請(qǐng)參見(jiàn)公共錯(cuò)誤碼。

taskId String file_t_6Tu1kOFV4Lw4g7dWMH4Yp1-1oB8Ci 檢測(cè)任務(wù)的ID。
dataId String test6WVsaaxBAkY5wWn4N6kCU$-1oB8Ci 檢測(cè)對(duì)象對(duì)應(yīng)的數(shù)據(jù)ID。
說(shuō)明 如果在檢測(cè)請(qǐng)求參數(shù)中傳入了dataId，則此處返回對(duì)應(yīng)的dataId。
textResults JSONArray 傳入textScenes時(shí)的文本掃描結(jié)果。關(guān)于具體結(jié)果描述，請(qǐng)參見(jiàn)文本審核中的返回參數(shù)部分。
imageResults JSONArray 傳入imageScenes時(shí)的圖片掃描結(jié)果。關(guān)于具體結(jié)構(gòu)描述，請(qǐng)參見(jiàn)圖片審核結(jié)果查詢中的返回參數(shù)部分。
url String https://aliyundoc.com/test/file/test3.docx?Expires=1521800184&OSSAccessKeyId=xxxxxxxxxxx&Signature=xxxxxxxxxxxx 被檢測(cè)源文件的鏈接。
msg String OK 請(qǐng)求參數(shù)的響應(yīng)信息。

示例

請(qǐng)求示例
http(s)://[Endpoint]/green/file/results
&<公共請(qǐng)求參數(shù)>
[
    "file_t_6Tu1kOFV4Lw4g7dWMH4Yp1-1oB8Ci",
    "file_image_t_5pvbNDryAe06MsUTytddIY-1oC1Db"
]
正常返回示例
{
    "code": 200,
    "data": [
        {
            "dataId": "test6WVsaaxBAkY5wWn4N6kCU$-1oB8Ci",
            "taskId": "file_t_6Tu1kOFV4Lw4g7dWMH4Yp1-1oB8Ci",
            "textResults": [
                {
                    "code": 200,
                    "content": "test",
                    "msg": "OK",
                    "results": [
                        {
                            "label": "normal",
                            "rate": 99.91,
                            "scene": "antispam",
                            "suggestion": "pass"
                        }
                    ],
                    "taskId": "file_text_t_5R3Pmeqkbl94kSNl5uvTKN-1oB8Cl"
                }
            ],
            "imageResults": [
                {
                    "msg": "OK",
                    "code": 200,
                    "results": [
                        {
                            "rate": 99.91,
                            "suggestion": "pass",
                            "label": "normal",
                            "scene": "terrorism"
                        },
                        {
                            "rate": 99.91,
                            "suggestion": "pass",
                            "label": "normal",
                            "scene": "porn"
                        }
                    ],
                    "taskId": "file_image_t_5pvbNDryAe06MsUTytddIY-1oC1Db",
                    "url": "http://aliyundoc.com/prod/hammal/2611c68/6_10188943_5inaGVFwoCSh3ii3pdjhAOWahE76XSySjmErLYhy_analysis_file.png?Expires=1522039397&OSSAccessKeyId=xxxxxxxx&Signature=xxxxxxxxxxxxxxxx"
                }
            ],
            "url": "https://aliyundoc.com/test/file/test3.docx?Expires=1521800184&OSSAccessKeyId=xxxxxxxxxxx&Signature=xxxxxxxxxxxx"
        }
    ],
    "msg": "OK",
    "requestId": "68C7BA1A-3F91-454A-A1B7-81CA032348F3"
}