在线检测接口V6(version: 603)
接口说明
本接口是智能风控服务的在线检测接口,需配合智能风控SDK使用,当SDK获取token后,将token传入该接口获取风险识别结果,详情请参考使用教程。该接口为实时检测接口,同步返回检测结果,当前接口版本为V6,version: 603。
历史子版本参考600、601、602。更新日志参考V6版本接口更新日志。
老版本参考在线检测接口V5和在线检测接口V4。
鉴权说明
易盾智能风控服务使用签名认证方法对接口进行鉴权,所有接口每一次请求都需要包含签名信息(signature 参数),以验证用户身份,防止信息被恶意篡改。目前支持MD5签名算法,详细信息请参见接口鉴权。
接入须知
- 如果您没有从客户端智能风控SDK获取到token或者获取到的token是null值,依然建议在业务场景节点(SDK埋点位置,如注册场景)调用检测接口。
- 请根据接口返回的风险等级进行相应业务处置,为了保障处置动作依据完备,如需对用户进行封号,建议结合用户/玩家的业务数据进行二次判断,或者与易盾技术人员进行二次确认,以确保准确无误。
- 请控制接口调用频率,默认qps为1000,频率过高,可能会超过频率限制,导致接口调用失败。上线前有需要提升qps需要可以联系易盾专属商务。
- 请登陆易盾官网后台风控引擎-服务管理查看当前业务的场景类型
请求不同业务场景下,需要传入的场景数据sceneData字段存在差异,具体请看下述场景参数描述不同场景接入说明。
请求说明
请求地址
名称 | 值 |
---|---|
HTTP URL | http://ir-open.dun.163.com/v6/risk/check |
HTTP Method | POST |
请求头
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
Content-Type | String | 是 | 固定值:"Content-Type:application/json" |
请求参数
部分产品相关参数请用账号登陆易盾官网控制台获取参考
请求参数包括:公共参数和私有参数。其中,公共参数如下:
参数 | 类型 | 必填 | 参与签名计算 | 最小长度 | 最大长度 | 描述 |
---|---|---|---|---|---|---|
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))。 |
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 | 自定义执行动作 |
字段名称 | 类型 | 说明 |
---|---|---|
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信息 |
字段名称 | 类型 | 说明 |
---|---|---|
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 | 设备的屏幕高度 |
字段名称 | 类型 | 说明 |
---|---|---|
mac | String | 设备物理地址 |
guid | String | 设备标识符 |
osVersion | String | 设备系统版本 |
screenResolution | String | 屏幕分辨率 |
osType | String | 操作系统型号信息 |
computerName | String | 计算机名 |
manufacturer | String | 设备制造商 |
osName | String | 操作系统名称 |
字段名称 | 类型 | 说明 |
---|---|---|
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:"{ }"