鉴定通知数据内容说明

文档中心

鉴定通知说明

鉴定通知安全机制
鉴定通知数据说明

鉴定通知安全机制

网宿云存储会在通知的请求头中，加入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
            }
        ]
    }
}