图片防刷版开发文档

2021.10.14 11:08:32

    防刷版说明

    防刷版将融合反作弊能力综合判定内容安全检测结果,目前易盾支持如下两种防刷版接入方式,对比如下:

    API防刷版 SDK防刷版
    接入方式 服务器api接口 前端接入SDK+服务器API接口
    获取信息 防刷字段(手机号、邮箱号、用户名、IP)+自定义扩展字 设备基本信息+设备指纹+防刷业务数据防刷字段(手机号、邮箱号、用户名、IP)+自定义扩展字
    优势说明 接入简单 获取信息更多
    效果说明 对比非防刷版,效果有较高提升 对比非防刷版,效果显著提升

    请根据自身产品情况选择接入不同模式的防刷版检测;

    SDK防刷版开发文档

    开发流程图

    SDK防刷版调用示意图

    步骤1:接入反作弊SDK

    接入请参考:http://support.dun.163.com/documents/15588071870066688?docId=70966851765719040&locale=zh-cn

    步骤2:接入图片检测api,传入反作弊token字段

    接口地址

    http://as.dun.163.com/v4/image/check

    接口描述

    建议您使用POST请求, 且仅接受 application/x-www-form-urlencoded 编码格式。

    该接口同步返回内容安全服务实时反垃圾引擎检测结果,产品根据图片分类结果,做图片初步过滤。由于网络环境及图片本身大小的影响(建议产品对图片进行压缩后,再过反垃圾检测),部分图片可能出现下载超时情况,该部分数据会返回检测失败,请重新检测。机器离线检测后,可能会有部分不确定的数据需要人工进一步确认。离线检测结果及人工确认结果需产品自行定期调用图片离线检测结果获取

    V3在线检测接口文档请点此下载查看

    图片限制

    ◆ 目前支持的图片文件格式有:jpg, png, bmp, gif, webp, tiff;

    ◆ 支持图片大小:单张<10M;

    ◆ 图片尺寸大小:不小于 50px*50px;

    ◆ gif图长图说明:易盾自动将gif图长图截帧过检,最多5张,gif图长图均按照实际截图张数进行计费;

    ◆ 长图定义:长宽比大于5的图片

    请求参数

    公共参数已省略,详细见 请求公共参数

    基本参数
    参数名称 类型 是否必选 最大长度 描述
    images String(json数组) Y 32张或10MB images为json数组,支持批量检测
    version String Y 4 接口版本v4

    images参数结构说明

    字段名称 类型 是否必选 最大长度 描述
    name String Y 1024 图片名称(或图片标识), 该字段为回调信号字段,产品可以根据业务情况自行设计,如json结构、或者为图片url均可
    type Number Y 4 类型,分别为1:图片URL,2:图片BASE64值
    data String Y 32张或者10MB 图片内容,如type=1,则该值为图片URL,如type=2,则该值为图片BASE64值。图片URL检测单次请求最多支持32张,图片BASE64值检测单次请求大小限制为最多10MB
    callbackUrl String N 256 离线结果回调通知到客户的URL。主动回调数据接口超时时间设置为2s,为了保证顺利接收数据,需保证接收接口性能稳定并且保证幂等性。
    业务参数

    业务扩展参数,有助于通过业务维度辅助反垃圾结果判定,建议传入。

    参数名称 类型 是否必选 最大长度 描述
    用户信息 - N - 用户信息包含账号、昵称、等级、角色等,请查看 业务扩展参数—用户信息
    设备信息 - N - 设备信息包含设备ID、设备ID类型等,请查看 业务扩展参数—设备信息
    场景信息 - N - 场景信息包含私聊、群聊、直播、帖子等场景字段,请查看 业务扩展参数—场景信息
    ip String N 32 用户IP地址
    checkLabels String数组 N 64 接口指定过检分类,可多选,指定后业务配置过检分类即失效,过检分类列表:100:色情,110:性感低俗,200:广告,210:二维码,260:广告法,300:暴恐,400:违禁,500:涉政,1100:涉价值观
    反垃圾防刷版专属字段

    如在您的内容检测场景中,存在一定作弊行为,建议开启反垃圾防刷版,如下参数,需开启反垃圾防刷功能后,传入方可生效,如需开启,请联系您的专属商务

    参数名称 类型 是否必选 最大长度 描述
    token String N 256 来自易盾反作弊SDK返回的token,接入SDK必传
    phone String N 11 用户手机号
    email String N 64 用户邮箱
    extension json N 512 扩展字段

    响应结果

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

    反垃圾结果

    antispam 数组数据结构

    参数名称 类型 描述
    name String 图片名称(或图片标识)
    taskId String 本次请求数据标识,可以根据该标识查询数据最新结果
    status Number 图片检测状态码,定义为:0:检测成功,610:图片下载失败,620:图片格式错误,630:其它
    action json对象 建议动作,2:建议删除,1:建议审核,0:建议通过
    labels json数组 分类信息

    labels 数据结构

    参数名称 类型 描述
    label Number 分类信息,100:色情,110:性感低俗,200:广告,210:二维码,260:广告法,300:暴恐,400:违禁,500:涉政,900:其他,1100:涉价值观
    subLabels json数组 细分类信息,可能包含多个,可能为空
    level json对象 分类级别,0:正常,1:不确定,2:确定
    rate Number 置信度分数,0-1之间取值,1为置信度最高,0为置信度最低。若level为正常,置信度越大,说明正常的可能性越高。若level为不确定或确定,置信度越大,说明垃圾的可能性越高

    subLabels 数据结构

    参数名称 类型 描述
    subLabel Number 细分类,详细编码请参考下方对应细分类编码 对照表
    rate Number 置信度分数,0-1之间取值,1为置信度最高,0为置信度最低
    details json对象 hitInfos:命中详细信息,针对subLabel的补充说明

    自定义细分类

    易盾支持sublabel自定义细分类过检并返回,如有需求,可联系您的专属运营经理添加。

    API防刷版开发文档

    接口地址

    http://as.dun.163.com/v4/image/check

    接口描述

    该接口同步返回内容安全服务实时反垃圾引擎检测结果,产品根据图片分类结果,做图片初步过滤。由于网络环境及图片本身大小的影响(建议产品对图片进行压缩后,再过反垃圾检测),部分图片可能出现下载超时情况,该部分数据会返回检测失败,请重新检测。机器离线检测后,可能会有部分不确定的数据需要人工进一步确认。离线检测结果及人工确认结果需产品自行定期调用图片离线检测结果获取

    V3在线检测接口文档请点此下载查看

    图片限制

    ◆ 目前支持的图片文件格式有:jpg, png, bmp, gif, webp, tiff;

    ◆ 支持图片大小:单张<10M;

    ◆ 图片尺寸大小:不小于 50px*50px;

    ◆ gif图长图说明:易盾自动将gif图长图截帧过检,最多5张,gif图长图均按照实际截图张数进行计费;

    ◆ 长图定义:长宽比大于5的图片

    请求参数

    公共参数已省略,详细见 请求公共参数

    基本参数

    参数名称 类型 是否必选 最大长度 描述
    images String(json数组) Y 32张或10MB images为json数组,支持批量检测
    version String Y 4 接口版本v4

    images参数结构说明

    字段名称 类型 是否必选 最大长度 描述
    name String Y 1024 图片名称(或图片标识), 该字段为回调信号字段,产品可以根据业务情况自行设计,如json结构、或者为图片url均可
    type Number Y 4 类型,分别为1:图片URL,2:图片BASE64值
    data String Y 32张或者10MB 图片内容,如type=1,则该值为图片URL,如type=2,则该值为图片BASE64值。图片URL检测单次请求最多支持32张,图片BASE64值检测单次请求大小限制为最多10MB
    callbackUrl String N 256 离线结果回调通知到客户的URL。主动回调数据接口超时时间设置为2s,为了保证顺利接收数据,需保证接收接口性能稳定并且保证幂等性。

    业务参数

    业务扩展参数,有助于通过业务维度辅助反垃圾结果判定,建议传入。

    参数名称 类型 是否必选 最大长度 描述
    ip String N 32 用户IP地址
    account String N 128 用户唯一标识,如果无需登录则为空
    deviceType Number N 4 用户设备类型,1:web, 2:wap, 3:android, 4:iphone, 5:ipad, 6:pc, 7:wp
    deviceId String N 128 用户设备 id

    反垃圾防刷版专属字段

    如在您的内容检测场景中,存在一定作弊行为,建议开启反垃圾防刷版,如下参数,需开启反垃圾防刷功能后,传入方可生效,如需开启,请联系您的专属商务

    参数名称 类型 是否必选 最大长度 描述
    email String N 64 用户邮箱
    phone String N 11 用户手机号
    extension json N 512 扩展字段

    扩展参数

    参数名称 类型 是否必选 最大长度 描述
    checkLabels String数组 N 64 接口指定过检分类,可多选,指定后业务配置过检分类即失效,过检分类列表:100:色情,110:性感低俗,200:广告,210:二维码,300:暴恐,400:违禁,500:涉政

    响应结果

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

    反垃圾结果

    antispam 数组数据结构

    参数名称 类型 描述
    name String 图片名称(或图片标识)
    taskId String 本次请求数据标识,可以根据该标识查询数据最新结果
    status Number 图片检测状态码,定义为:0:检测成功,610:图片下载失败,620:图片格式错误,630:其它
    action json对象 建议动作,2:建议删除,1:建议审核,0:建议通过
    labels json数组 分类信息

    labels 数据结构

    参数名称 类型 描述
    label Number 分类信息,100:色情,110:性感低俗,200:广告,210:二维码,300:暴恐,400:违禁,500:涉政,900:其他
    subLabels json数组 细分类信息,可能包含多个,可能为空
    level json对象 分类级别,0:正常,1:不确定,2:确定
    rate Number 置信度分数,0-1之间取值,1为置信度最高,0为置信度最低。若level为正常,置信度越大,说明正常的可能性越高。若level为不确定或确定,置信度越大,说明垃圾的可能性越高

    subLabels 数据结构

    参数名称 类型 描述
    subLabel Number 细分类,详细编码请参考下方对应细分类编码 对照表
    rate Number 置信度分数,0-1之间取值,1为置信度最高,0为置信度最低
    details json数组 hitInfos:命中详细信息,针对subLabel的补充说明

    自定义细分类

    易盾支持sublabel自定义细分类过检并返回,如有需求,可联系您的专属运营经理添加。

    响应示例

    输出结果:

    注:分类信息,100:色情,110:性感,200:广告,210:二维码,300:暴恐,400:违禁,500:涉政

    {
    	"code": 200,
    	"msg": "ok",
    	"antispam": [{
    		"taskId": "2930cd4b13464676a0779ef09706e700",
    		"status": 0,
    		"action": 2,
    		"name": "1234",
    		"labels": [{
    			"label": 500,
    			"level": 2,
    			"rate": 1.0,
    			"subLabels": [{
    				"subLabel": 50003,
    				"rate": 1.0,
    				"details": {
    					"hitInfos": ["XXX"]
    				}
    			}]
    		}, {
    			"label": 200,
    			"level": 1,
    			"rate": 1.0,
    			"subLabels": []
    		}, {
    			"label": 100,
    			"level": 0,
    			"rate": 0.9999522,
    			"subLabels": []
    		}, {
    			"label": 110,
    			"level": 0,
    			"rate": 0.9999522,
    			"subLabels": []
    		}, {
    			"label": 210,
    			"level": 0,
    			"rate": 1.0,
    			"subLabels": []
    		}, {
    			"label": 300,
    			"level": 0,
    			"rate": 0.9642776,
    			"subLabels": []
    		}, {
    			"label": 400,
    			"level": 0,
    			"rate": 1.0,
    			"subLabels": []
    		}]
    	}, {
    		"taskId": "0f6260acdb7647e281e41874189206e9",
    		"status": 0,
    		"action": 2,
    		"name": "1234",
    		"labels": [{
    			"label": 500,
    			"level": 2,
    			"rate": 1.0,
    			"subLabels": [{
    				"subLabel": 50003,
    				"rate": 1.0,
    				"details": {
    					"hitInfos": ["XXX"]
    				}
    			}]
    		}, {
    			"label": 200,
    			"level": 1,
    			"rate": 1.0,
    			"subLabels": []
    		}, {
    			"label": 100,
    			"level": 0,
    			"rate": 0.9999522,
    			"subLabels": []
    		}, {
    			"label": 110,
    			"level": 0,
    			"rate": 0.9999522,
    			"subLabels": []
    		}, {
    			"label": 210,
    			"level": 0,
    			"rate": 1.0,
    			"subLabels": []
    		}, {
    			"label": 300,
    			"level": 0,
    			"rate": 0.92121917,
    			"subLabels": []
    		}, {
    			"label": 400,
    			"level": 0,
    			"rate": 1.0,
    			"subLabels": []
    		}]
    	}],
    	"ocr": [{
    		"taskId": "2930cd4b13464676a0779ef09706e700",
    		"name": "1234",
    		"details": [{
    			"content": "直播CCTV1综合",
    	   "background": "complex",
    			"lineContents": [{
    				"lineContent": "直播",
    				"polygon": [0.7745177268981933, 0.09276469945907592, 0.8768445968627929, 0.0939750075340271, 0.8766385078430176, 0.1636715531349182, 0.7743116855621338, 0.16246124505996704]
    			}, {
    				"lineContent": "CCTV1",
    				"polygon": [0.12932851314544677, 0.09998217821121216, 0.23668222427368163, 0.10091289281845092, 0.2365492343902588, 0.16227685213088988, 0.12919551134109497, 0.16134613752365112]
    			}, {
    				"lineContent": "综合",
    				"polygon": [0.14835870265960693, 0.15775651931762696, 0.23298816680908202, 0.15898795127868653, 0.23278720378875734, 0.21423439979553222, 0.14815772771835328, 0.21300296783447265]
    			}]
    		}]
    	}, {
    		"taskId": "0f6260acdb7647e281e41874189206e9",
    		"name": "1234",
    		"details": [{
    			"content": "直播CCTV1综合",
    	   "background": "complex",
    			"lineContents": [{
    				"lineContent": "直播",
    				"polygon": [0.7745157241821289, 0.09276466369628907, 0.8768444061279297, 0.09396190643310547, 0.876640510559082, 0.1636584758758545, 0.7743117809295654, 0.1624612331390381]
    			}, {
    				"lineContent": "CCTV1",
    				"polygon": [0.1293278932571411, 0.0999821662902832, 0.23668241500854492, 0.100907301902771, 0.2365502119064331, 0.16227684020996094, 0.1291956901550293, 0.16135170459747314]
    			}, {
    				"lineContent": "综合",
    				"polygon": [0.14835870265960693, 0.15775651931762696, 0.23298816680908202, 0.15898795127868653, 0.23278720378875734, 0.21423439979553222, 0.14815772771835328, 0.21300296783447265]
    			}]
    		}]
    	}]
    
    	"face": [{
    		"taskId": "57132814c2a24350a337d0a76dd49bbf",
    		"name": "xxxx",
    		"details": [{
    			"faceNumber": 1,
    			"faceContents": [{
    				"name": "XXXX",
    				"x1": 0.41362658,
    				"y1": 0.18348134,
    				"x2": 0.50894177,
    				"y2": 0.37411177
    			}]
    		}]
    	}]
    	
    	}
    
    Online Chat Tel:95163223