在线检测接口V6(version: 603)

2024.11.25 17:57:07

    接口说明

    本接口是智能风控服务的在线检测接口,需配合智能风控SDK使用,当SDK获取token后,将token传入该接口获取风险识别结果,详情请参考使用教程。该接口为实时检测接口,同步返回检测结果,当前接口版本为V6,version: 603。
    历史子版本参考600601602。更新日志参考V6版本接口更新日志
    老版本参考在线检测接口V5在线检测接口V4

    鉴权说明

    易盾智能风控服务使用签名认证方法对接口进行鉴权,所有接口每一次请求都需要包含签名信息(signature 参数),以验证用户身份,防止信息被恶意篡改。目前支持MD5签名算法,详细信息请参见接口鉴权

    接入须知

    1. 如果您没有从客户端智能风控SDK获取到token或者获取到的token是null值,依然建议在业务场景节点(SDK埋点位置,如注册场景)调用检测接口。
    2. 请根据接口返回的风险等级进行相应业务处置,为了保障处置动作依据完备,如需对用户进行封号,建议结合用户/玩家的业务数据进行二次判断,或者与易盾技术人员进行二次确认,以确保准确无误。
    3. 请控制接口调用频率,默认qps为1000,频率过高,可能会超过频率限制,导致接口调用失败。上线前有需要提升qps需要可以联系易盾专属商务。
    4. 请登陆易盾官网后台风控引擎-服务管理查看当前业务的场景类型image title 请求不同业务场景下,需要传入的场景数据sceneData字段存在差异,具体请看下述场景参数描述不同场景接入说明

    请求说明

    请求地址

    名称
    HTTP URL http://ir-open.dun.163.com/v6/risk/check
    HTTP Method POST

    请求头

    名称 类型 必填 描述
    Content-Type String 固定值:"Content-Type:application/json"

     

    请求参数

    部分产品相关参数请用账号登陆易盾官网控制台获取参考image title

    请求参数包括:公共参数和私有参数。其中,公共参数如下:

    参数 类型 必填 参与签名计算 最小长度 最大长度 描述
    businessId String 10 32 每个业务接入时,会分配唯一的业务 ID。
    secretId String 32 36 产品密钥,每个应用接入时,会分配secretId和私钥secretKey。
    timestamp Long 13 13 接口调用时的UNIX时间戳,单位:毫秒,用于判断请求是否过期
    nonce String 32 32 随机码,用于防止重放,固定长度32个字符,不能重复,建议使用UUID
    version String 3 3 当前页面接口版本号:603
    signature String 32 32 使用 secretKey 生成的签名,用于身份验证,生成方法见接口鉴权

    私有参数如下:

    参数名 类型 必填 最大长度 描述
    token String 是(API模式除外) 15000 在客户端调用getToken服务后返回给客户端的检测凭证:token。
    - 客户端到易盾网络正常情况时生成短token,长度根据平台不同有所区别: 32byte(web/小程序sdk)或40byte(android/ios/pc)
    - 网络质量不好或者域名被屏蔽情况下,生成离线token,平均长度在4k-8kb左右,长token和短token具有相同的检测效果,请勿对token进行截断,为保证检测效果,建议客户端获取token后30分钟内及时提交检测。
    详情请查看客户端接入说明文档。
    account String 256 用户账号标识,建议使用业务方用户的UID,标记用户的唯一身份。
    roleId String 256 用户角色ID,适用于支持同一个账号下创建不同角色的业务(如游戏不同区服的角色)。
    nickname String 256 用户账号/角色的昵称。
    ip String 128 用户的IP,或当前客户端业务事件发生时的客户端请求IP地址(ipv4格式),若无法拿到ip,可以传入一个定值,为了效果准确考虑,建议传入真实ip。
    phone String 64 用户账号关联的手机号码(部分业务,账号名=手机号码),默认为国内手机号码。
    如有海外手机号码,需要包含国家地区代码,格式为“+447410xxx186”(+44即为国家码)。
    支持数据加密,请传入hash值(hash算法:md5(phone))。
    email String 64 用户账号关联的电子邮箱地址,必须是有效的电子邮件格式,传入格式要求为: xx@××。
    registerTime Long 13(参数长度必须是13位) 用户/角色注册、创建时间点。请传入时间戳,单位:毫秒。
    注意:若传入该字段,系统会进行参数格式强校验,参数长度必须是13位,如:1689733747268。
    registerIp String 64 用户/角色注册、创建时的IP地址,如有记录,可传入辅助进行风险判断。
    level String 32 用户账号等级、财富等级等,有助于对不同等级用户设置分层策略,方便业务进行精细化安全运营。
    注意:level 由业务自定义,风控系统除长度外不会有任何其他校验手段,请业务需要自行管理、维护 level 字典。
    identity String - 当前用户身份,有助于对不同身份用户设置分层策略,方便业务进行精细化安全运营。
    注意:仅接收以下内容,若传入该字段,系统将会强制校验传入值合法性。
    - visitor:游客
    - commonUser:普通用户
    - seniorUser:高级用户(如vip、主播)
    - other:其他身份
    payUser Boolean - 当前用户是否付费用户,有助于对用户设置分层策略。
    注意:仅接收布尔值,若传入该字段,系统将会强制校验传入值合法性。
    - true:付费用户
    - false:非付费用户
    verified Boolean - 当前用户是否认证用户(实名/真人认证),有助于对不同安全等级用户设置分层策略。
    注意:仅接收布尔值,若传入该字段,系统将会强制校验传入值合法性。
    - true:认证用户
    - false:非认证用户
    activityId String 256 事件的细分标记,用于标记场景事件下的细分类别,如同样是促销活动,可用于区分:双十一促销、618促销;再如同样是邀请拼团活动,activityId标记本次邀请的唯一识别ID
    deviceId String 128 当前用户的设备ID。
    注意:如果通过SDK模式接入,则可不传,优先使用SDK生成的设备ID,API模式下强烈建议传入。
    clientCode Integer - 客户端接口状态码,调用客户端SDK getToken接口时,接口返回的Code码,可参照客户端接入文档。如实际调用过程中没有获取到code值,则请传入:0
    sceneData String - 请登陆易盾官网后台风控引擎-服务管理查看当前业务的场景类型,不同业务场景下的请求,需要传入的场景数据存在差异,具体请看下述场景参数描述。不同场景接入说明
    注意:如果接入场景为“其他”,则sceneData可传空"{ }"。
    extData String 10240 根据业务定制需求,额外需要传入系统的信息,可用于配置业务定制的检测规则。

     

    请求参数示例

    {
        "businessId": "a0bcmo3aa617x1n62tlhtragdd009wy1",
        "secretId": "b0bcmo3aa617x1n62tlhtragdd009wy2",
        "timestamp": 1701837991081,//传入时以当前时间为准
        "nonce": "c0bcmo3aa617x1n62tlhtragdd009wy3",
        "version": "603",
        "signature": "d0bcmo3aa617x1n62tlhtragdd009wy4",
        "token": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",//以客户端传递的token为准
        "ip":  "1.1.1.1",
        "roleId":  "xxxxxxx",
        "account":  "yyyyyyy",
        "nickname":  "zzzzzzz",
        "phone": "15888886666",    
        "email":  "xxx@126.com",     
        "registerTime": 1701937991081        
        "registerIp":  "127.0.0.1",    
        "level":  "150",
        "identity":  "visitor",
        "payUser":  true,
        "verified":  false,
        "activityId":  "activityId",      
        "deviceId":  "381xfu028f2083u230fuc2",
        "clientCode":  0,
        "sceneData": "{\"loginType\":\"userPassword\",\"appChannel\":\"app_store\",\"registerDay\":999,\"hashPassword\":\"adfdafjk123kjfkljdaf\",\"identity\":\"visitor\",\"paidUser\":false,\"verifiedUser\":false}"
        "extData": "{\"otherInfo\":\"其他字段信息\"}"
    }
    
    

    响应

    响应结果

    响应数据格式为:JSON。

    响应头为:Content-Type:application/json,具体如下:

    参数 类型 描述
    code Integer 响应码,正常情况下为200,异常时,见 附录响应码定义
    msg String 响应码说明,正常情况下返回“ok”,异常时,见 附录响应码定义
    desc String 响应信息描述,非必返,常见错误情况下会返回错误说明或错误参考文档
    data JSONObject 返回数据,格式下表说明

    检测结果的数据格式:

    参数 类型 说明
    riskLevel Integer 风险等级:0 正常,1 低风险,2 中风险,3 高风险,4 可信源。 风险等级只会返回一个,取本次命中的最高风险等级
    hitInfos List 命中风险信息,例如:[{"type":"12401067","name":"环境风险-ROOT-通用","riskLevel":"风险等级"}]。
    如果同时命中多个类型,则会返回全部命中风险信息。详细风险标签参考智能风控风险标签
     ∟ type String 风险标签type
     ∟ name String 命中的风险标签对应的名称,命中的标签的上下级名称采用‘-’进行拼接
     ∟ riskLevel Integer 风险等级
     ∟ rules List 命中规则列表
    taskId String 检测任务 ID,建议记录存储,便于后续数据查询验证。
    sdkRespData String 风控检测结果加密数据,仅在token数据能成功解析时返回该字段,应用/游戏方可转交给风控 sdk 解析处理。
    deviceId String 购买设备指纹功能后,check结果中才会包含deviceId。
    pcId String 如当前为在PC机器上的多开Android模拟器环境,则返回PC的指纹ID,开通了设备指纹功能的才会返回。
    matchedRules List 命中规则编号列表
    matchedCustomRules List 命中自定义规则编号列表
    deviceInfo JSONObject 设备信息, Android设备返回的字段见Androd设备信息,IOS设备返回字段见IOS设备信息
    evidences List 证据信息
    phoneInfo JSONObject 手机号画像信息,开通了手机号画像功能的才会返回。
     ∟ basicInfo JSONObject 手机号基础信息
      ∟ carrier String 运营商
      ∟ province String 省份
      ∟ city String 城市
     ∟ phoneRiskInfo JSONObject 手机号画像信息
      ∟ riskType String 风险类型
      ∟ riskLevel Integer 风险等级:0-低风险,1-中风险,2-高风险
      ∟ riskScore Double 风险分值:0.0~1.0,分值越高被黑产持有的概率越高
    ipInfo JSONObject IP信息
     ∟ sdkIp String 易盾通过SDK上报数据链路获取的客户端本地IP,与定位信息可能不同
     ∟ basicInfo JSONObject IP基础信息,在check接口返回配置中设置。
      ∟ isp String 运营商
      ∟ continent String 大洲
      ∟ country String 国家
      ∟ province String 省份
      ∟ city String 城市
      ∟ longitude String 经度
      ∟ latitude String 纬度
     ∟ ipRiskInfo JSONObject IP画像信息,开通了IP画像功能的才会返回。
      ∟ riskType String 风险类型
      ∟ riskLevel Integer 风险等级:0-低风险,1-中风险,2-高风险
      ∟ riskScore Double 风险分值:0.0~1.0,分值越高被黑产持有的概率越高
    action Integer 执行动作:0-放行,1-闪退,2-弹窗,3-弹窗+闪退
    customAction Integer 自定义执行动作

    Androd设备信息

    字段名称 类型 说明
    screenInfo String 屏幕信息
    appVersion String app版本号
    bootCount Integer 设备启动次数
    chargeState Integer 充电状态
    macRandom Integer 是否开启mac随机化,0:未随机化,1:随机化,2:未知,3:mac地址存在错误
    screenBright Integer 屏幕亮度
    checkAdb Integer adb是否开启,0:否,1:是
    upTime String 手机已启动时间
    osVersion String Android版本,如7.0,8.1.0
    carrierName String 运营商
    lockTime String 手机总锁屏时间
    isFakeCam Integer 是否是虚拟摄像头,0:不是,1:是
    phoneBrand String 手机品牌
    firstSetupTime String 第一次安装时间
    hasSim Integer 是否存在sim卡,-1:无,1:有
    model String 型号
    isShareScreen Integer 投屏状态判断,0:不是,1:是
    networkType Integer 网络连接类型,1:wifi,2:2g,3:3g,4:4g,5:5g
    batteryLevel Integer 当前电量信息
    apkLibName List 当前app的so列表,可用于检查、校验so列表是否被篡改
    oaid String 设备广告ID
    aaid String 应用广告ID
    deviceType Integer 硬件设备类型,1:手机,2:桌面,3:汽车,4:电视,6:手表 其他值忽略
    cpuInfo String 设备cpu信息
    sdTotal String 设备sd卡总内存大小
    memTotal String 设备总内存大小
    language String 设备语言设置
    userRegion String 设备当前地区设置
    productManufacturer String 设备厂商信息
    productOS String 设备系统名称
    rom String 设备ROM信息

    IOS设备信息

    字段名称 类型 说明
    bootTime String 开机时间
    totalDiskSpace String 硬盘大小,单位字节
    auxo Integer 非完美越狱失效状态,0:未越狱,1:越狱,2:越狱失效
    macSerialnumber String mac序列号
    chargeStatus String 0:未开启电池权限,1:未充电,2:充电中,电池电量小于100,3:充电中,电池电量充满
    deviceId String 客户端本地生产的设备 ID
    isCydiaSubstrate Integer 是否安装CydiaSubstrate,0:否,1:是
    isAntiJailbreak Integer 是否有反越狱插件,0:否,1:是
    totalMemory String 总内存,单位字节
    osVersion String 手机操作系统版本
    carrierName String 运营商名称
    model String 手机型号
    cpuUseRate String cpu 使用率
    networkType Integer 网络连接类型,1:wifi,2:2g,3:3g,4:4g,5:5g
    batteryLevel String 当前电量信息
    loadedDyLibsInfo List 动态加载库
    deviceName String 设备名称
    idfv String iOS设备标识符
    screenWidth String 设备的屏幕宽度
    screenHeight String 设备的屏幕高度

    PC设备信息

    字段名称 类型 说明
    mac String 设备物理地址
    guid String 设备标识符
    osVersion String 设备系统版本
    screenResolution String 屏幕分辨率
    osType String 操作系统型号信息
    computerName String 计算机名
    manufacturer String 设备制造商
    osName String 操作系统名称

    WEB设备信息

    字段名称 类型 说明
    url String 地址栏当前url
    screenResolution JSONObject 屏幕尺寸
    runEnvType Integer web类型,1:Mobile Web(俗称 Wap/H5),2:Desktop Web(俗称 PC Web),3:Unknown
    userAgent String 浏览器标识信息
    language String 浏览器的语言设置
    platform String 浏览器所在设备的系统类型

    小程序设备信息

    字段名称 类型 说明
    networkType String 当前小程序所在设备的联网类型,可能值:wifi/2g/3g/4g/5g/unknown/none
    version String 小程序版本号
    type Integer 小程序类型,可能值:20:微信,30:支付宝,40:字节,50:百度,60:快手
    brand String 运行小程序的设备的品牌
    platform String 浏览器所在设备的系统类型

    鸿蒙设备信息

    字段名称 类型 说明
    oaid String 设备广告ID
    aaid String 应用广告ID
    screenInfo String 屏幕信息
    deviceType String 硬件设备类型,phone:手机,tablet:平板,2in1:2合一设备,tv:电视,wearable:手表 car:车
    cpuInfo String 设备cpu信息
    memTotal String 总运行内存大小
    memFree String 空闲运行内存大小
    language String 设备语言设置
    osVersion String 设备系统版本

    响应结果示例

    • 识别结果正常时:
    {
        "msg": "成功",
        "code": 200,
        "data": {
            "hitInfos": [],
            "sdkRespData": "CMgBEgbmiJDlip8aIJcTg0fhlH67cdCnp2qH5G+iKMyuY/sl84xxOsREylTY",
            "riskLevel": 0,
            "matchedRules": [],
            "phoneInfo": {
                "phoneRiskInfo": {
                    "riskLevel": 2,
                    "riskType": "14001,14002,14005",
                    "riskScore": 0.982
                },
                "basicInfo": {
                    "carrier": "移动",
                    "province": "浙江",
                    "city": "金华"
                }
            },
            "pcId": "",
            "ipInfo": {
                "ipRiskInfo": {
                    "riskType": ""
                }
            },
            "deviceId": "d7Ozri3oF4ZFTQEQRQfAATvkTCIu220Q",
            "deviceInfo": {
                "screenInfo": "1080x2412",
                "appVersion": "3.2.2",
                "bootCount": 2,
                "chargeState": 2,
                "macRandom": 0,
                "screenBright": 99,
                "checkAdb": 0,
                "upTime": "1133968",
                "osVersion": "14",
                "carrierName": "cm",
                "lockTime": "519311",
                "isFakeCam": 0,
                "phoneBrand": "OPPO",
                "firstSetupTime": "1720065348049",
                "hasSim": 1,
                "model": "PJV110",
                "isShareScreen": 0,
                "networkType": 1,
                "batteryLevel": 85
            },
            "taskId": "d03skdumqwyurdtvcqg33fmgdd00a8wu",
            "matchedCustomRules": [],
            "action": 0
        },
        "ok": true
    }
    
    • 识别结果异常时:
      {
        "msg": "成功",
        "code": 200,
        "data": {
            "hitInfos": [
                {
                    "riskLevel": 3,
                    "name": "业务风险-风险手机号-虚拟号",
                    "rules": [
                        "R20231029202431309"
                    ],
                    "type": "12401383"
                }
            ],
            "sdkRespData": "CMgBEgbmiJDlip8aIHP5JfcbaajTcyLPku09O/EkxoX6uBHp4MK/CIKKlmqi",
            "riskLevel": 3,
            "matchedRules": [
                "R20231029202431309"
            ],
            "phoneInfo": {
                "phoneRiskInfo": {
                    "riskType": ""
                },
                "basicInfo": {
                    "carrier": "电信",
                    "province": "河北",
                    "city": "张家口"
                }
            },
            "pcId": "",
            "ipInfo": {
                 "sdkIp":"192.168.2.123",
                  "basicInfo":{  
                       "isp":"运营商",
                       "continent":"大洲",
                       "country":"国家",
                       "province":"省份",
                      "city":"城市",
                     "longitude":"经度",
                     "latitude":"纬度"
                 },
                "ipRiskInfo": {
                    "riskType": ""
                }
            },
            "deviceId": "xRabJGWYG81AWVBFVVPVcKVCy18MoAAS",
            "deviceInfo": {
                "screenInfo": "1080x2388",
                "appVersion": "3.2.2",
                "bootCount": 324,
                "chargeState": 3,
                "macRandom": 0,
                "screenBright": 255,
                "checkAdb": 0,
                "upTime": "165672",
                "osVersion": "12",
                "carrierName": "ct",
                "lockTime": "60528",
                "isFakeCam": 0,
                "phoneBrand": "HONOR",
                "firstSetupTime": "1721195698797",
                "hasSim": 1,
                "model": "TFY-AN00",
                "isShareScreen": 0,
                "networkType": 1,
                "batteryLevel": 79
            },
            "taskId": "mmvk974w2fg4umcw430i8crgdd00a8wt",
            "matchedCustomRules": [],
            "evidences": ["证据"]
        },
        "ok": true
    }
    
    

    注意事项

    • 当返回无数据时,可能原因包括数据处理延时、数据不存在;
    • 自动封禁有风险,操作请谨慎,建议参考其他因素综合考虑。

    响应返回码

    响应返回码见:响应返回码

    接入示例代码

    服务端 SDK 接入

    推荐使用我们提供的服务端 SDK 进行接入(目前支持 Java 和 Go 两种语言),不但可以节省接入成本,实现更快速的集成,并享有灵活的请求配置选项,同时 SDK 内置了错误重试、熔断降级等功能,提升服务可用性。点击 服务端 SDK 接入指引了解更多。

    Github Demo 地址

    sceneData数据构建规范说明

    不同场景接入说明

    易盾智能风控系统支持客户给予业务,不同场景下,回传给风控系统不同的检测数据,以期达到更好的检测效果。基于不同类型场景,易盾提供以下 sceneData 数据构建规范:

     

    游戏反外挂

    游戏反外挂

    参数名 类型 必填 最大长度 描述
    gameVersion String 32 游戏的版本号
    assetVersion String 32 游戏的资源版本号
    serverId String 64 当前游戏角色所在游戏区服的ID(所属服务器ID)
    serverName String 32 当前游戏角色所在游戏区服的名称(所属服务器名称)
    gameJson String - 仅用于游戏同步在客户端调用setRoleInfo时填入的gameJson信息,为json格式的字符串

     

    注册登录保护

    注册

    参数名 类型 必填 最大长度 描述
    registerType String - 注册方式,可选参数内容如下:
    - userPassword:用户名密码注册
    - phoneAuth:手机号一键注册(包含短信验证码方式注册方式)
    - otherPlatformAuth:第三方平台授权注册(如微信授权注册等)
    - unknown:未知注册方式
    registerChannel String - 如果是“第三方平台授权注册”,可传入注册渠道,可选参数内容如下:
    - qq:qq授权注册
    - weixin:微信授权注册
    - alipay:支付宝授权注册
    - weibo:微博授权注册
    - other:未知/其他平台授权注册
    inviterId String 128 如为邀请注册制,可填写邀请人的邀请码、账号ID等唯一标识信息
    hashPassword String 128 加密后的用户密码
    registerChannelMark String 128 如可获取注册流量来源平台/渠道(特别适用于通过web、小程序方式进行的注册),可传入平台/渠道的唯一识别码。如:
    - 腾讯平台:传入点击回调中的 click_id
    - 巨量平台:传入点击回调中的 CALLBACK_PARAM
    可根据业务是否获取相关信息及是否需要根据表示进行检测决定是否传入此参数
    gender String - 注册用户的性别,如应用注册时有明确的性别信息,可通过此处传入。可选参数内容如下:
    - male
    - female
    appChannel String 32 用户使用的应用来源渠道(或者说是app的上架渠道),如用户是从GooglePlay下载应用,则可传入:googleplay。如业务无法获知当前应用的来源渠道,可传入:unknown

    登录

    参数名 类型 必填 最大长度 描述
    loginType String - 当前用户登录方式,可选参数如下:
    - userPassword:使用用户名、密码登录
    - phoneAuth:使用手机号码授权登录(包含短信验证码方式登录方式)
    - qq:qq授权登录
    - weixin:微信授权登录
    - alipay:支付宝授权登录
    - weibo:微博授权登录
    - other:未知/其他平台授权登录
    gender String - 登录用户的性别,如应用登录时有明确的性别信息,可通过此处传入。可选参数内容如下:
    - male
    - female
    appChannel String 32 用户使用的应用来源渠道(或者说是app的上架渠道),如用户是从GooglePlay下载应用,则可传入:googleplay。如业务无法获知当前应用的来源渠道,可传入:unknown
    registerDay Long 8 用户账号注册天数
    hashPassword String 128 加密后的用户密码
    identity String - 区分用户在业务中的身份类型(通常可用于根据业务需要进行策略研究、布控),可传入参数包括:
    - visitor:游客身份
    - commonUser:普通用户
    - seniorUser:高级用户(如vip、主播、司机等)
    - other:未知/其他身份
    paidUser Boolean - 用于标记是否付费用户,以方便实施策略布控:
    - true:付费客户
    - false:非付费客户
    verifiedUser Boolean - 用于标记是否经过实名/信息认证后的用户,以方便实施策略布控:
    - true:认证客户
    - false:非认证客户
    realUser Boolean - 用于标记是否经过真人认证后的用户,以方便实施策略布控:
    - true:认证客户
    - false:非认证客户
    loginChannelMark String 128 如可获取注册流量来源平台/渠道(特别适用于通过web、小程序方式进行的登录),可传入平台/渠道的唯一识别码。如:
    - 腾讯平台:传入点击回调中的 click_id
    - 巨量平台:传入点击回调中的 CALLBACK_PARAM
    可根据业务是否获取相关信息及是否需要根据表示进行检测决定是否传入此参数
    openId String 128 微信小程序用户唯一标识:openID

    注册&登录

    参数名 类型 必填 最大长度 描述
    registerOrLogType String - 注册或登录方式,可选参数内容如下:
    - userPassword:用户名密码注册或登录
    - phoneAuth:手机号一键注册或登录(包含短信验证码方式注册方式)
    - otherPlatformAuth:第三方平台授权注册或登录(如微信授权注册等)
    - unknown:未知注册或登录方式
    operationType String - 标记本次行为属性,是注册还是登录
    -register:本次行为为注册行为
    -log:本次行为为登录行为
    registerOrLogChannel String - 如果是“第三方平台授权注册或登录”,可传入注册或登录渠道,可选参数内容如下:
    - qq:qq授权注册或登录
    - weixin:微信授权注册或登录
    - alipay:支付宝授权注册或登录
    - weibo:微博授权注册或登录
    - other:未知/其他平台授权注册或登录
    inviterId String 128 如为邀请注册制,可填写邀请人的邀请码、账号ID等唯一标识信息
    hashPassword String 128 加密后的用户密码
    registerOrLogChannelMark String 128 如可获取注册流量来源平台/渠道(特别适用于通过web、小程序方式进行的注册),可传入平台/渠道的唯一识别码。如:
    - 腾讯平台:传入点击回调中的 click_id
    - 巨量平台:传入点击回调中的 CALLBACK_PARAM
    可根据业务是否获取相关信息及是否需要根据表示进行检测决定是否传入此参数
    gender String - 注册用户的性别,如应用注册时有明确的性别信息,可通过此处传入。可选参数内容如下:
    - male
    - female
    appChannel String 32 用户使用的应用来源渠道(或者说是app的上架渠道),如用户是从GooglePlay下载应用,则可传入:googleplay。如业务无法获知当前应用的来源渠道,可传入:unknown
    registerDay Long 8 如本次行为为登录,则传入用户账号注册天数
    paidUser Boolean - 用于标记是否付费用户,以方便实施策略布控:
    - true:付费客户
    - false:非付费客户
    verifiedUser Boolean - 用于标记是否经过实名/信息认证后的用户,以方便实施策略布控:
    - true:认证客户
    - false:非认证客户
    realUser Boolean - 用于标记是否经过真人认证后的用户,以方便实施策略布控:
    - true:认证客户
    - false:非认证客户
    openId String 128 微信小程序用户唯一标识:openID

    验证

    参数名 类型 必填 最大长度 描述
    verifyType String - 当前执行的验证手段类型,可选传入参数包括:
    - upLinkSMS:上行短信验证
    - downLinkSMS:下行短信验证
    - oneClick:一键无感验证
    - captcha:滑动、点选、推理、语序等验证
    - voice:语音验证
    - face:人脸验证
    verifyResult String - 验证是否成功,可选传入参数包括:
    - success:验证通过
    - fail:验证失败

     

    社交互动保护

    私聊

    参数名 类型 必填 最大长度 描述
    targetId String 128 聊天对象ID(用户ID)
    contentType String - 用户发送的聊天信息类型,可传入参数包括:
    - text:文本
    - image:图片
    - video:视频
    - audio:音频
    - link:链接
    content String 1024 如聊天内容的文本,则传入文本信息(可用于做轻量级文本检测)
    chatId String 64 当前聊天对话的会话ID,1v1聊天唯一识别ID(只要聊天双方对象未发生改变,则会话id不变)

    群聊/直播间等多人场景

    参数名 类型 必填 最大长度 描述
    chatGroupId String 128 当前群组、直播间等公共空间ID
    contentType String - 用户发送的聊天信息类型,可传入参数包括:
    - text:文本
    - image:图片
    - video:视频
    - audio:音频
    - link:链接
    content String 1024 如聊天内容的文本,则传入文本信息(可用于做轻量级文本检测)

    送礼

    参数名 类型 必填 最大长度 描述
    targetIdList List<String> 数组最大元素个数: 100
    字符串元素最大长度: 128
    送礼对象用户ID,如送礼对象为多个,则可传入多个对象ID
    giftId String 64 礼品ID
    giftPrice Double 8 礼品价格,可以是应用内货币,也可以是真实货币,如为后者,则默认货币计量单位:CNY,单位:元

    打招呼

    参数名 类型 必填 最大长度 描述
    targetIdList List<String> 数组最大元素个数: 100
    字符串元素最大长度: 128
    打招呼对象ID,如打招呼对象为多个,则可传入多个对象ID
    content String 1024 打招呼文本内容

    打赏

    参数名 类型 必填 最大长度 描述
    targetId String 128 打赏对象ID,通常为主播ID、内容作者ID
    rewardPrice Double 8 打赏金额,通常为真实货币,默认货币计量单位:CNY,单位:元
    relatedId String 64 打赏关联内容ID,通常用于文章、视频打赏场景

    加入群组/进入直播间

    参数名 类型 必填 最大长度 描述
    chatGroupId String 64 用户加入的群组对象的ID
    groupName String 64 用户加入的群组的名称
    groupNum Long 8 群组成员数量
    groupLevel Long 8 用于标记群组等级
    joinType String - 用户标记本次加群行为是用户主动申请,还是群邀请,可传入参数包括:
    - userApply:用户主动申请
    - invited:用户被邀请

    创建群组

    参数名 类型 必填 最大长度 描述
    chatGroupId String 64 用户创建的群组的ID
    groupName String 64 用户创建的群组的名称

    加好友/匹配

    参数名 类型 必填 最大长度 描述
    targetId String 128 加好友对象用户ID
    psText String 1024 加好友附言文本

     

    运营/营销活动保护

    签到

    参数名 类型 必填 最大长度 描述
    signInDays Long 8 用户累计签到天数
    getAward Boolean - 标记当前行为是否行为激励的方式之一:
    - true:是行为激励
    - false:不是行为激励
    awardId String 64 如当前行为是行为激励形式之一,则传入用户可获取到的激励物品ID
    awardNum Long 8 如激励物品可通过数字衡量,可传入激励物品的数量(如积分)

    做任务

    参数名 类型 必填 最大长度 描述
    taskId String 64 任务的唯一标识ID
    taskType String 64 任务的类型,如:看视频、点赞、签到、下载等
    getAward Boolean - 标记任务是否行为激励的方式之一:
    - true:是行为激励
    - false:不是行为激励
    awardId String 64 如当前行为是行为激励形式之一,则传入用户可获取到的激励物品ID
    awardNum Long 8 如激励物品可通过数字衡量,可传入激励物品的数量(如积分)
    inviterId String 128 如任务为邀请制,则传入邀请人
    invitationCode String 128 如任务为邀请制,传入邀请码(如邀请链接、二维码中的邀请码,凡是用于标记邀请的唯一标识的字段)
    openId String 128 微信小程序用户唯一标识:openID

    抽奖

    参数名 类型 必填 最大长度 描述
    taskId String 64 抽奖行为唯一标识ID
    result Integer - 标记抽奖结果:
    - 1:中奖
    - 0:没中奖
    awardId String 64 如当前行为是行为激励形式之一,则传入用户可获取到的激励物品ID
    awardNum Long 8 如激励物品可通过数字衡量,可传入激励物品的数量(如积分)
    awardLevel Integer - 用于标记奖品等级,可分为以下三类:
    - 1:初级奖品(低价值奖品)
    - 2:中级奖品
    - 3:高级奖品(高价值奖品)
    openId String 128 微信小程序用户唯一标识:openID

    领券

    参数名 类型 必填 最大长度 描述
    couponType String 64 用户所领券的类型,如:满减券、免单券、打折券等
    couponSource String 64 用户所领券的来源渠道,如商户发放、平台发放等
    couponId String 64 用户所领券的唯一标识ID
    couponPrice Double 8 如券可通过数字衡量价值,可传入具体的价值(如券的金额)
    openId String 128 微信小程序用户唯一标识:openID

    抢红包

    参数名 类型 必填 最大长度 描述
    redEnvelopeType String 64 红包类型,如口令红包、随机红包等
    redEnvelopSource String - 红包来源类型,可选传入参数包括:
    - user:用户发的红包
    - official:官方发的红包
    - store:商家发的红包(适用于应用存在第三方入驻商户的情况)
    - other:未知/其他方发的红包
    redEnvelopOwnerId String 128 如红包来源用户、商户,则传入用户ID、商户ID
    redEnvelopPrice Double 8 红包的金额,货币计量单位:CNY,单位:元

    活动发起邀请

    参数名 类型 必填 最大长度 描述
    invitationCode String 128 本次邀请唯一识别ID,如邀请码等
    getAward Boolean - 标记当前行为是否行为激励的方式之一:
    - true:是行为激励
    - false:不是行为激励
    awardId String 64 如当前行为是行为激励形式之一,则传入用户可获取到的激励物品ID
    awardNum Long 8 如激励物品可通过数字衡量,可传入激励物品的数量(如积分)
    invitationType String 32 标记当前邀请活动类型,如邀请注册、邀请助力砍价等
    requireNum Long 8 如邀请活动的奖励是阶梯式的,请传入最低获取奖励所要求的接受邀请人数
    inviter String 64 邀请对象用户ID/手机号

    活动受邀

    参数名 类型 必填 最大长度 描述
    invitationCode String 128 本次邀请唯一识别ID,如邀请码等
    inviterId String 128 邀请人的用户ID
    groupId String 64 如接受的是诸如拼团等活动,则传入团ID

    点赞

    参数名 类型 必填 最大长度 描述
    contentId String 128 点赞对象ID
    ownerId String 128 被点赞对象拥有者用户ID
    times Long 8 点赞对象累计被点赞次数
    getAward Boolean - 标记当前行为是否行为激励的方式之一:
    - true:是行为激励
    - false:不是行为激励
    awardId String 64 如当前行为是行为激励形式之一,则传入用户可获取到的激励物品ID
    awardNum Long 8 如激励物品可通过数字衡量,可传入激励物品的数量(如积分)

    评论

    参数名 类型 必填 最大长度 描述
    contentId String 128 评论对象ID
    ownerId String 128 被评论对象拥有者用户ID
    times Long 8 评论对象累计被评论次数
    comment String 1024 评论的文本内容
    getAward Boolean - 标记当前行为是否行为激励的方式之一:
    - true:是行为激励
    - false:不是行为激励
    awardId String 64 如当前行为是行为激励形式之一,则传入用户可获取到的激励物品ID
    awardNum Long 8 如激励物品可通过数字衡量,可传入激励物品的数量(如积分)

    转发/分享

    参数名 类型 必填 最大长度 描述
    contentId String 128 转发/分享对象ID
    ownerId String 128 被转发/分享对象拥有者用户ID
    times Long 8 转发/分享对象累计被转发/分享次数
    targetId String 64 如转发/分享目标对象是用户、群,可传入用户、群ID
    shareChannel String - 转发/分享的通道,可选传入参数包括:
    - self:通过当前app自身渠道转发
    - weixin:转发/分享到微信
    - qq:转发/分享到qq
    - weibo:转发/分享到微博
    - other:未知/其他分享渠道
    getAward Boolean - 标记当前行为是否行为激励的方式之一:
    - true:是行为激励
    - false:不是行为激励
    awardId String 64 如当前行为是行为激励形式之一,则传入用户可获取到的激励物品ID
    awardNum Long 8 如激励物品可通过数字衡量,可传入激励物品的数量(如积分)

    收藏

    参数名 类型 必填 最大长度 描述
    contentId String 128 收藏对象ID
    ownerId String 128 被收藏对象拥有者用户ID
    times Long 8 收藏对象累计被收藏次数
    goodsPrice Double 8 被收藏对象如为商品,可上传商品价格。货币计量单位:CNY,单位:元
    getAward Boolean - 标记当前行为是否行为激励的方式之一:
    - true:是行为激励
    - false:不是行为激励
    awardId String 64 如当前行为是行为激励形式之一,则传入用户可获取到的激励物品ID
    awardNum Long 8 如激励物品可通过数字衡量,可传入激励物品的数量(如积分)

    关注

    参数名 类型 必填 最大长度 描述
    followId String 128 关注对象ID(可以是被关注的用户ID、商户ID等)
    getAward Boolean - 标记当前行为是否行为激励的方式之一:
    - true:是行为激励
    - false:不是行为激励
    awardId String 64 如当前行为是行为激励形式之一,则传入用户可获取到的激励物品ID
    awardNum Long 8 如激励物品可通过数字衡量,可传入激励物品的数量(如积分)

    web商品页面防爬

    参数名 类型 必填 最大长度 描述
    url String 256 当前页面链接URL地址
    pageNum Long 8 当前页面页码
    goodsCode String 64 商品编号/编码
    categoryCode String 64 商品类别编号
    storeCode String 64 店铺编号/编码
    goodsPrice Double 8 商品售价,货币计量单位:CNY,单位:元
    salesNumber Long 8 商品销售量

    扫码

    参数名 类型 必填 最大长度 描述
    validQR Boolean - 扫码结果是否有效(可协助过滤掉打开扫描之后误扫其他二维码的情况、或重复扫描已经使用过的二维码):
    - true:有效
    - false:无效
    pinCode String 128 二维码的Pin码
    trueQR Boolean - 二维码通过易盾内容安全识别确定的是否真实的二维码:
    - true:是
    - false:否
    openId String 128 微信小程序用户唯一标识:openID
    imgData String - 二维码图片经过Base64编码后的字符串
    如需启用二维码图片检测,请联系易盾运营人员。

     

    支付安全保护

    充值

    参数名 类型 必填 最大长度 描述
    payTime Long 13 角色充值到账时间,UNIX 时间戳(毫秒值)
    appChannel String 32 客户端app的渠道,如:appstore、googleplay
    money Double 8 商店定价货币额度,50元(换算人民币)以下记录准确金额,50元(换算人民币)以上可都记录为50元
    currency String 16 商店定价货币类型,如:USD、EUR、CNY,参考货币代码表(ISO4217)
    payMoney Double 8 支付货币额度,50元(换算人民币)以下记录准确金额,50元(换算人民币)以上可都记录为50元
    payCurrency String 16 玩家实际支付货币类型,如:USD、EUR、CNY,参考货币代码表(ISO4217)
    payChannel String 32 支付渠道,如app_store、google、H5等)
    orderId String 128 app_store/google/其他渠道唯一订单号
    app_store:iOS的transactionId,例如:160001456292965
    google:Google订单号,例如:GPA.3329-6166-4658-28227
    orderCreateTime Long 13 订单创建时间,UNIX 时间戳(毫秒值)
    orderPayTime Long 13 订单支付时间,UNIX 时间戳(毫秒值)
    orderFinishTime Long 13 订单发货时间,UNIX 时间戳(毫秒值)
    callbackUrl String 256 回调接口地址,用于坏账治理结果回调通知业务方,如果您开通了坏账治理功能,请在此处填入回调接口,否则检测结果仅可通过页面查询获取。
    仅检测到异常时会回调通知,正常订单不会调用回调接口。

    消费

    参数名 类型 必填 最大长度 描述
    createTime Long 13 用户账号/角色创建时间点,UNIX 时间戳(毫秒值)
    cost Long 8 消费货币数(可以是真实金额、应用/游戏中的货币数)

    积分/券等兑换

    参数名 类型 必填 最大长度 描述
    goodsId String 64 用户兑换的商品ID
    listingTime Long 13 商品上架的时间点
    goodsCount Long 8 兑换商品数量
    unitPrice Double 8 商品的实际单价,通常为真实货币,默认货币计量单位:CNY,单位:元
    totalPrice Double 8 兑换商品总价格,通常为真实货币,默认货币计量单位:CNY,单位:元
    consumption Long 16 兑换商品消耗的积分、券数量
    costIdList List<String> 数组最大元素个数: 100
    字符串元素最大长度: 128
    如兑换商品消耗的是诸如优惠券、折扣券等,可传入券的ID,如消耗多个,可传入多个ID
    receivingAddress String 256 收货地址,兑换商品填写的收货地址
    receivingPhone String 64 收货手机号,兑换商品填写的收货手机号

    提现

    参数名 类型 必填 最大长度 描述
    withdrawCount Double 8 用户提现的金额,默认货币计量单位:CNY,单位:元
    withdrawAccount String 64 用户提现账号的ID,如支付宝账号ID、微信账号ID等
    withdrawType String - 用户提现渠道/方式,可传入参数包括:
    - bank:提现到银行卡
    - weixin:提现到微信
    - alipay:提现到支付宝
    - other:未知/其他提现渠道

    退款

    参数名 类型 必填 最大长度 描述
    refundTime Long 13 订单退款时间,UNIX 时间戳(毫秒值)
    orderId String 128 app_store/google/其他渠道唯一订单号
    app_store:iOS的transactionId,例如:160001456292965
    google:Google订单号,例如:GPA.3329-6166-4658-28227
    refundReason String 64 用户退款原因
    callbackUrl String 256 回调接口地址,用于坏账治理结果回调通知业务方,如果您开通了坏账治理功能,请在此处填入回调接口,否则检测结果仅可通过页面查询获取。

    仅检测到异常时会回调通知,正常订单不会调用回调接口。

     

    航司票务

    查询/浏览航班

    参数名 类型 必填 最大长度 描述
    passenger String 16 乘机人
    startCity String 16 出发城市名称/缩写
    endCity String 16 到达城市名称/缩写
    pageId String 256 票务信息页面ID/ url
    stayTime Integer - 页面停留时长,单位毫秒(ms)

    订票

    参数名 类型 必填 最大长度 描述
    orderId String 128 订单编号
    passenger String 16 乘机人
    roundTrip Boolean - 是否往返票
    startDate String 16 去程日期,格式为:2024-01-01
    endDate String 16 返程日期,格式为:2024-01-01
    startCity String 16 出发城市名称/缩写
    endCity String 16 到达城市名称/缩写
    flightId String 256 航班号,如有中转/往返或其他情况下多个航班,则用|分割航班号
    airlineId String 256 航线的编码,如分段航线或多个航线,则用|进行分割
    contactsName String 16 下单时联系人姓名
    contactsPhone String 64 下单时联系人手机号

    退票

    参数名 类型 必填 最大长度 描述
    orderId String 128 订单编号
    passenger String 16 乘机人
    interval Long 16 下订单到取消时间,单位毫秒(ms)
    roundTrip Boolean - 是否往返票
    startDate String 16 去程日期,格式为:2024-01-01
    endDate String 16 返程日期,格式为:2024-01-01
    startCity String 16 出发城市名称/缩写
    endCity String 16 到达城市名称/缩写
    flightId String 256 航班号,如有中转/往返或其他情况下多个航班,则用|分割航班号

    添加乘客

    参数名 类型 必填 最大长度 描述
    passengerList List 10 提交表单中的乘客列表;对象列表字段,对象字段信息详见下诉 passengerList内容

    passengerList内容

    参数名 类型 必填 最大长度 描述
    passengerCode String 128 乘客身份证号(可加密,无需明文,确保唯一性即可)
    passengerName String 16 乘客姓名

    支付订单

    参数名 类型 必填 最大长度 描述
    orderId String 128 支付订单编号
    flightId String 256 航班号,如有中转/往返或其他情况下多个航班,则用|分割航班号
    paymentAccountType String - 支付账号类型,可选值如下:
    - bank:银联支付
    - weixin:微信支付
    - alipay:支付宝支付
    - others:其他支付渠道
    paymentId String 128 支付账号唯一ID
    voucherTimestamp Long - 支付凭证上的时间戳
    orderResult Boolean - 订单是否成功,可选值如下:
    - true:支付成功
    - false:支付失败

    按航班号查询

    参数名 类型 必填 最大长度 描述
    flightId String 128 航班号,如有中转/往返或其他情况下多个航班,则用|分割航班号
    startDate String 16 航班起飞日期,格式:2024-01-01

     

    其他

    其他场景情况下,sceneData无强制要求,可传空串,例如sceneData:"{ }"

    Online Chat Tel:95163223 Free trial