网站检测离线结果获取

接口地址

http://as.dun.163yun.com/v1/crawler/callback/results

接口描述

异步查询提交的主动检测结果

请求参数

该接口参数与请求公共参数一致,businessId可不传,详细见 请求公共参数

参数名称类型是否必选最大长度描述
versionStringY4接口版本v1.0

响应结果

响应字段如下,响应通用字段已省略,详细见响应通用字段:

result 数组数据结构

参数名称类型描述
dataIdString数据唯一标识,能够根据该值定位到该条数据,如对数据结果有异议,可以发送该值给客户经理查询
taskIdString主动检测数据请求标识,可以根据该标识查询文档数据最新结果
callbackString产品调用主动检测提交接口传递的 callback 字段数据。
resultNumber检测结果, 1:正常(建议通过) 2:异常(建议拦截) 3:疑似(建议人工确认)0:无结果(检测失败)
failureReasonNumber检测失败原因
evidencesjson对象证据信息

failureReason 说明

错误码描述
1000页面资源大小超过上限
1001页面资源contentType不支持
1002页面资源下载失败
2000页面资源提取失败
2001页面资源提取超时
3000页面检测失败
3001页面文本资源检测失败
3002页面图片资源检测失败

evidences 数据结构

参数名称类型描述
textsjson对象数组文本证据信息
imagesjson对象数组图片证据信息

texts 数据结构

参数名称类型描述
taskIdString当前分段检测数据标识
sequenceNumber当前文本在原始文档中的分段(5000字符/段)序号
startTextString每段文本的起始20个字符
endTextString每段文本的结尾20个字符
actionNumber检测结果,0:通过,1:嫌疑,2:不通过
labelsjson对象数组分类信息 详细数据与文本在线检测labels数据结构一致

images 数据结构

参数名称类型描述
taskIdString当前图片检测数据标识
sequenceNumber当前图片在原始文档中的序号
imageUrlString图片下载地址
levelNumber分类级别,0:正常,1:不确定,2:确定
labelsjson对象数组分类信息 详细数据与图片在线检测labels数据结构一致

请求示例

    /** 产品密钥ID,产品标识 */
    private final static String SECRETID = "your_secret_id";
    /** 产品私有密钥,服务端生成签名信息使用,请严格保管,避免泄露 */
    private final static String SECRETKEY = "your_secret_key";
    /** 易盾反垃圾云服务文档检测结果获取接口地址 */
    private final static String API_URL = "http://as.dun.163yun.com/v1/crawler/callback/results";
    /** 实例化HttpClient,发送http请求使用,可根据需要自行调参 */
    private static HttpClient httpClient = HttpClient4Utils.createHttpClient(100, 20, 10000, 2000, 2000);

    /**
     *
     * @param args
     * @throws Exception
     */
    public static void main(String[] args) throws Exception {
        Map<String, String> params = new HashMap<String, String>();
        // 1.设置公共参数
        params.put("secretId", SECRETID);
        params.put("version", "v1.0");
        params.put("timestamp", String.valueOf(System.currentTimeMillis()));
        params.put("nonce", String.valueOf(new Random().nextInt()));

        // 2.生成签名信息
        String signature = SignatureUtils.genSignature(SECRETKEY, params);
        params.put("signature", signature);

        // 3.发送HTTP请求,这里使用的是HttpClient工具包,产品可自行选择自己熟悉的工具包发送请求
        String response = HttpClient4Utils.sendPost(httpClient, API_URL, params, Consts.UTF_8);

        // 4.解析接口返回值
        JsonObject resultObject = new JsonParser().parse(response).getAsJsonObject();
        int code = resultObject.get("code").getAsInt();
        String msg = resultObject.get("msg").getAsString();
        if (code == 200) {
            JsonArray resultArray = resultObject.getAsJsonArray("result");
            System.out.println(resultArray);
        } else {
            System.out.println(String.format("ERROR: code=%s, msg=%s", code, msg));
        }

    }

响应示例

当获取到离线结果时,输出示例如下:

{
    "code":200,
    "msg":"ok",
    "result":[
        {
            "dataId":"3104109",
            "taskId":"4b3ab6a00b8847a5835bc47157cf52fc",
            "callback":"367299101",
            "result":2,
            "evidences":{
                "texts":[
                    {
                        "taskId":"e7793532bba04cc3a9149f4f11d59487",
                        "sequence":0,
                        "startText":"第0083章 烧!烧!烧!火焰熊熊烧!",
                        "endText":"瓦娜斯将军,是没人能担得起这个责任的。",
                        "action":2,
                        "labels":[
                            {
                                "level":2,
                                "details":{
                                    "hint":[
                                        "火焰熊熊烧"
                                    ]
                                },
                                "label":200
                            }
                        ]
                    }
                ],
                "images":[
                    {
                        "taskId":"f4eb2be9330e48c3b24d6eaa287a3977",
                        "sequence":0,
                        "imageUrl":"https://yidun-antispam.nos-eastchina1.126.net/f4eb2be9330e48c3b24d6eaa287a3977?Signature=P%2B7GNQ6HZ4929woAAQQX11x2jkmlVrNPf%2B7SJxFD600%3D&Expires=1555391928&NOSAccessKeyId=a681ebcbcd5646a488d275c33acb16bd",
                        "level":2,
                        "labels":[
                            {
                                "level":2,
                                "rate":1,
                                "label":200,
                            }
                        ]
                    }
                ]
            }
        },
        {
            "dataId":"3104110",
            "taskId":"4b3ab6a00b8847a5835bc47157cf52xx",
            "callback":"367299101",
            "result":0,
            "failureReason":1000
        }
    ]
}

当无最新离线结果需要获取时,输出示例如下:

{"code":200,"msg":"ok"}
QQ咨询:反馈更及时 在线咨询 电话咨询:95163223