请求参数#

请求url#

  • 北京:http://api-img-bj.fengkongcloud.com/v2/saas/anti_fraud/img

  • 上海:http://api-img-sh.fengkongcloud.com/v2/saas/anti_fraud/img

  • 广州:http://api-img-gz.fengkongcloud.com/v2/saas/anti_fraud/img

  • 新加坡:http://api-img-xjp.fengkongcloud.com/v2/saas/anti_fraud/img

请求方法#

POST

字符编码#

UTF-8

建议超时时间#

5s

请求参数#

放在HTTP Body中,采用Json格式,具体参数如下:

参数名称类型是否必选说明
accessKeystringY用于权限认证,开通账号服务时由数美提供
typestringN选择识别类型,可选值:
涉政识别:POLITICS
色情识别:PORN
图片中的OCR文字识别:OCR
广告识别:AD
视频水印logo识别:LOGO
不良场景识别:BEHAVIOR
支持吸烟、喝酒、赌博、吸毒、避孕套和无意义画面
如果需要多个识别功能,通过下划线连接
AD_PORN_POLITICS用于广告、色情和涉政组合识别
注:这里POLITICS实际上等价于以下两个类型:
涉政人脸识别:PERSON
暴恐识别:VIOLENCE
建议传入:POLITICS_PORN_AD_BEHAVIOR
appIdstringN应用标识
用于区分相同公司的不同应用
该参数传递值可与数美服务协商用于区分应用
默认应用值:default
callbackstringN回调http接口
当该字段非空时,服务将根据该字段回调通知用户审核结果
datajson_objectY请求数据内容,最长10MB

其中,data的内容如下:

参数名称类型是否必选说明
imgstringY要检测的图片
可使用图片的base64编码或者图片的url链接
支持格式:jpg,jpeg,jp2,png,webp,gif,bmp,tiff,tif,dib,ppm,pgm,pbm,hdr,pic
建议图片像素不小于256*256
tokenIdstringY客户端用户唯一标识
用于用户行为分析,建议传入用户UID
注:不同用户务必传入不同的tokenId对其进行唯一标识
btIdstringN用户指定的图片标识
当callback存在时,在回调请求中向用户返回
不支持特殊字符
channelstringN数据场景,取值需要与数美协商
registerTimeintN帐号注册时间
强烈建议传递此参数,新注册帐号的异常操作风险较高,毫秒级时间戳
friendNumintN帐号好友数
社交场景强烈推荐传此参数,标识用户质量
fansNumintN帐号粉丝数
直播/社区场景强烈推荐传此参数,标识用户质量
isPremiumUserintN是否为优质(如付费)用户
配置不同等级,标识用户质量,可能取值:
优质账号:1
默认值:0
ipstringN客户端IP
该参数用于IP维度的用户行为分析,同时可用于比对数美IP黑库
receiveTokenIdstringN接收者的tokenId,私聊场景必选
sexintN用户的性别,可选值:
女性:0
男性:1
ageintN用户的年龄,可选值:
青年(大约18-45岁):0
中年(大约45-60岁):1
老年(大于60岁):2
levelintN用户等级
针对不同等级的用户可配置不同拦截策略,
rolestringN用户角色
对不同角色可配置不同策略。
直播领域可取值:
房管:ADMIN
主播:HOST
系统角色:SYSTEM
游戏领域可取值:
管理员:ADMIN
普通用户:USER
缺失或者默认普通用户:USER
topicstringN讨论的话题编号
可为书评区编号、论坛帖子编号
phonestringN用户手机号
可用于比对数美手机号黑库
deviceIdstringN强烈建议传入
数美设备指纹标识,用于用户行为分析
当恶意用户篡改mac、imei等设备信息时
使用deviceId能够发现和识别此类恶意行为,同时可用于比对数美设备指纹黑名单
imeistringN用户android设备唯一标识
相比tokenId和IP,imei和mac更难被更换,当恶意用户使用多个不同账户和IP进作恶时,通过imei和mac能够有效关联识别此类恶意行为,同时可用于比对数美设备黑名单
macstring
idfvstringN用户iOS应用唯一标识,相比tokenId和IP,idfv不能被修改,当恶意用户使用多个不同账户和IP进行恶意行为时,使用idfv能够发现和识别此类恶意行为
idfastring
maxFrameintN最大截帧数量
GIF图检测专用,默认值为20
当interval*maxFrame小于该图片所包含的图片数量时,截帧间隔会自动修改为该图片所包含的图片数/maxFrame,以提高整体检测效果
intervalintN截帧频率
GIF图检测专用,默认值为1
每interval张图片抽取一张进行检测
passThroughjson_objectN该字段内容同返回结果一起返回

请求示例#

{
"accessKey":"yourkey",
"type":"POLITICS_PORN_AD",
"data":{
"img":"http://www.leilingfushi.com/UpFiles/Article/2017/5/11/2017051152012237.jpg",
"tokenId":"test"
}
}