鉴定通知说明

鉴定通知安全机制

网宿云存储会在通知的请求头中,加入Authorization字段。
格式:

<Accesskey>:<Urlsafe_Base64_Encode(hmac_sha1(detectNotifyURLWithOutQuery+"\n"+detectNotifyBody,SecretKey))>

注:
1.detectNotifyBody为接收到的鉴定通知内容;
2.网宿云存储随机选取用户下的任一一组有效AK、SK生成鉴权头部Authorization的值。鉴权过程中,需记录所有AK、SK组,用其中一组正确匹配的密钥串进行头部鉴定。

鉴定通知数据说明

设置鉴定通知地址detectNotifyURL、detectNotifyRule后,该地址会获取到一个经过URL安全的Base64编码json格式的detectNotifyBody信息,该信息内容为根据鉴定通知规则获取到的鉴定结果。
注:接收鉴定结果通知的地址,必须是公网URL地址,能正常响应HTTP/1.1 200 OK,若有空格等特殊字符,需要进行Url Encode编码。
通知接口:

<detectNotifyURL>?message_type=<message_type>
message_type 参数值 描述
ws_contentDetect_image 图片鉴定结果

内容格式:

图片鉴黄

{
    "detectId": "<detectId>",
    "cmd": "<cmd>",
    "bucket": "<bucket>",
    "isZip": <isZip int>,
    "pornDetect": {
        "code": <ResultCode int>,
        "message": "<ResultMessage string>",
        "fileList": [
            {
                "key": "<key string>",
                "url": "<url string>",
                "rate": <Rate float>,
                "label": <Category int>,
                "review": <Review boolean>,
                "error": <Error string>
            }
        ]
    }
}

图片鉴恐

{
    "detectId": "<detectId>",
    "cmd": "<cmd>",
    "bucket": "<bucket>",
    "isZip": <isZip int>,
    "terrorDetect": {
        "code": <ResultCode int>,
        "message": "<ResultMessage string>",
        "fileList": [
            {
                "key": "<key string>",
                "url": "<url string>",
                "rate": <Rate float>,
                "label": <Category int>,
                "review": <Review boolean>,
                "error": <Error string>
            }
        ]
    }
}

政治人物识别

{
    "detectId": "<detectId>",
    "cmd": "<cmd>",
    "bucket": "<bucket>",
    "isZip": <isZip int>,
    "politicalDetect": {
        "code": <ResultCode int>,
        "message": "<ResultMessage string>",
        "fileList": [
            {
                "key": "<key string>",
                "url": "<url string>",
                "label": <Category int>,
                "error": <Error string>,
                "persons": [
                    {
                        "name": <Name string>,
                        "rate": <Rate float>,
                        "review": <Review boolean>,
                    }
                ]
            }
        ]
    }
}

说明:

字段名 类型 描述
detectId string 送检任务的唯一标识
cmd string 鉴定参数,即contentDetect的值
imagePorn-图片鉴黄, imageTerror-图片鉴恐, imagePolitical-政治人物识别
bucket string 空间名
isZip int 是否是压缩文件鉴定
0表示普通文件鉴定
1表示压缩文件鉴定
code int 状态响应码
message string 与状态码相应的详细描述
fileList array 送检的文件鉴定结果列表
key string 鉴定文件的key值
url string 鉴定文件的URL访问地址。如果是压缩文件鉴定,则该访问地址为压缩包的访问URL
rate float 介于0-1间的浮点数,表示该图像被识别为某个分类的概率值,概率越高,机器对于识别的结果越肯定
label int 整数,表示该图像被机器判定为哪个分类,根据不同的鉴定类型有所不同,分别对应
imagePorn: 0色情,1性感, 2正常
imageTerror: 0非暴恐,1暴恐
imagePolitical: 0非政治人物,1政治人物
如果为-1,则表示图片异常
review boolean 鉴定服务是否对结果确定,是否需要人工复审该图片。true需要,false不需要
name string 鉴定为政治人物时的政治人物名称
error string 图片鉴定异常,返回异常信息。鉴定正常,返回null

范例:

{
    "detectId": "21_981211192091345dabbbed38114a5ca6a7b764d587e2241",
    "cmd": "imagePorn",
    "bucket": "test",
    "isZip": 1,
    "pornDetect": {
        "code": 200,
        "message": "调用成功",
        "fileList": [
            {
                "key": "imagePorn_20160715142837628.jpg",
                "url":"http://test.com/imagePorn.zip",
                "rate": 0.9999998807907104,
                "label": 0,
                "review": false,
                "error": null
            }
        ]
    }
}