天眼

风控 风险控制 收单机构 商户 开发者 发卡机构
基于设备指纹技术,提供设备识别与设备评分服务。

接入服务商:银联技术开放平台

API ID:50

接口状态:正常

请咨询联系人
暂不支持测试

接口名称

注册保护接口

接口描述

注册保护接口

接口地址

测试地址: 暂无


生产地址: https://device.95516.com/dcs_svc/outside/registerCheck

请求方式

HTTP POST

请求报文体参数

名称 标识 字段类型 长度 请求要求 默认值 备注
id id string 6 M-必填 由天眼系统分配给每个接入方的唯一id
ts ts string 10 M-必填 当前请求的unix时间戳,例如:1502177222
random random string 32 M-必填 随机数,与ts结合防重放
version version string 4 M-必填 接口版本号,当前版本为v1.0
请求的签名 signature string 32 M-必填
dfpSessionId dfpSessionId string 42 M-必填 设备指纹服务返回给SDK的token,js通过cookie可以直接获取,ios和android通过相应的获取token的函数拿到
userId userId string O-选填 长度 <=256;业务系统的用户ID,可提供哈希值,如md5(userId)
email email string 64 O-选填 注册用户的邮箱,需提供哈希值,如:md5(email)
mobile mobile string 64 O-选填 注册用户的手机号,需提供哈希值,如:md5(mobile)
ip ip string 20 O-选填 注册用户的ip
注册用户的使用的昵称 nickname string 40 O-选填

应答参数

名称 标识 字段类型 长度 请求要求 默认值 备注
应答码 respCd string 4 M-必填 应答码,不同的应答码代表不同的业务含义,详见应答码说明
应答提示信息 msg string 12 M-必填
应答数据 data string 128 M-必填

接口名称

登陆保护接口

接口描述

登陆保护接口

接口地址

测试地址: 暂无


生产地址: https://device.95516.com/dcs_svc/outside/loginCheck

请求方式

HTTP POST

请求报文体参数

名称 标识 字段类型 长度 请求要求 默认值 备注
id id string 6 M-必填 由天眼系统分配给每个接入方的唯一id
ts ts string 10 M-必填 当前请求的unix时间戳,例如:1502177222
random random string 32 M-必填 随机数,与ts结合防重放
version version string 4 M-必填 接口版本号,当前版本为v1.0
signature signature string 32 M-必填 请求的签名
dfpSessionId dfpSessionId string 42 M-必填 设备指纹服务返回给SDK的token,js通过cookie可以直接获取,ios和android通过相应的获取token的函数拿到
userId userId string O-选填 长度 <=256;业务系统的用户ID,可提供哈希值,如md5(userId)
email email string 64 O-选填 登录用户的邮箱,需提供哈希值,如:md5(email)
mobile mobile string 64 O-选填 登录用户的手机号,需提供哈希值,如:md5(mobile)
ip ip string 20 O-选填 登录用户的ip

应答参数

名称 标识 字段类型 长度 请求要求 默认值 备注
应答码 respCd string 4 M-必填 应答码,不同的应答码代表不同的业务含义,详见应答码说明
应答提示信息 msg string 12 M-必填
应答数据 data string 128 M-必填

接口名称

设备信息查询

接口描述

设备信息查询

接口地址

测试地址: 暂无


生产地址: https://device.95516.com/dcs_svc/info/query

请求方式

HTTP POST

请求报文体参数

名称 标识 字段类型 长度 请求要求 默认值 备注
id id string 6 M-必填 由天眼系统分配给每个接入方的唯一id
ts ts string 10 M-必填 当前请求的unix时间戳,例如:1502177222
random random string 32 M-必填 随机数,与ts结合防重放
version version string 4 M-必填 接口版本号,当前版本为v1.0
signature signature string 32 M-必填 请求的签名
dfpSessionId dfpSessionId string 42 M-必填 设备指纹服务返回给SDK的token,js通过cookie可以直接获取,ios和android通过相应的获取token的函数拿到

应答参数

名称 标识 字段类型 长度 请求要求 默认值 备注
respCd respCd string 4 M-必填 应答码,不同的应答码代表不同的业务含义,详见应答码说明
msg msg string 12 M-必填 应答提示信息
data data string 128 M-必填 应答数据
产品亮点

    天眼通过对软硬件信息的采集,再结合天眼专利算法,更加精确的定位和识别网络中的设备。采用大数据技术和机器学习技术对轨迹模型的好坏样本进行全面科学的分析,不停的对模型进行更新迭代,保证设备识别与评估的准确性和高效性。

应用场景

注册及登陆场景

◆在应用端进行注册或登陆环节中,通过设备与账户的关系,保护客户的账户安全,防止出现拖库撞库、批量操作、恶意攻击等情况 

营销场景

◆当客户进行营销活动时,天眼可以在营销活动中侦测羊毛党、黄牛党的行为并进行相应的处理决策,从而使更多的用户体验到效果,从而达到更好的营销目的。

支付场景

◆在支付环节,包括二维码生成环节,对设备情况进行监控,通过风险模型的控制,选择合适的风险决策,保障用户在支付环节的安全。

应用对象

机构,商户,持卡人

接入流程

了解详细接入流程,请联系天眼接口人:

中国银联 银联科技事业部 潘辰:联系电话(021-20633276 ) 邮箱(panchen@unionpay.com


应答码参照:
应答码 描述
0000 成功
1000 参数不合法,包括:缺少必填字段、参数值长度不合法、时间戳不合法
1001 报文重放
1002 验签失败
1003 传过来的中文等字符不是使用UTF-8格式
2000 服务器内部错误
3001 请求报文格式不正确
3002 根据dfpSessionId查找不到devid
3003 Session已经过期
3004 正在计算中
3005 类型不匹配,疑似sid被copy到不同类型机器上
3006 采集的报文含有乱码
3007 某个设备在指定时间内查询次数超过限制