文档
测试

数据采集API接口

POST
https://infoup.shieldapi.com/

method⽅法值

shield.risk.policy.data

数据提交方式

机构如不在APP上集成SDK,可以通过服务端发送数据到Shield平台 上传的数据包括 通讯录,短信列表,图片信息,设备信息,APP列表 不同类型信息分开上传 注意:所有数据上传成功之后,才可以开始调用Shield 神盾策略API接口

设备信息

参数名
类型
描述
必填
appId
String
商户唯一标识
必填
packageName
String
包名
必填
version
String
APP版本
必填
borrowId
String
订单标识
必填
transactionId
String
唯一数据识别号,可使用机构用户ID
必填
userPhone
String
用户手机号码
必填
type
String
固定填写 device
必填
deviceInfo
JSON
设备信息
必填
batteryLevel
Int
电池电量
可选
batteryStatus
Tinyint
电池状态 1:未知 2:正在充电 3:放电中 4:未充电 5:电量充满
可选
cashCanUse
String
内存可用
可选
cashTotal
String
内存大小
可选
cellularNetworkIp
String
蜂窝网络IP
可选
containSd
String
是否有内置sd卡
可选
deviceWidth
String
分辨率宽
可选
deviceHeight
String
分辨率高
可选
deviceLanguage
String
默认语言
可选
deviceTime
String
设备时间
可选
extraSd
String
是否有外置SD卡
可选
gpsLatitude
String
gps纬度
可选
gpsLongitude
String
gps经度
可选
imei
String
imei设备标识
可选
productionDate
String
出厂日期
可选
isSimulator
Tinyint
是否模拟器 1:是 0:否
可选
isp
String
运营商
可选
mac
String
mac地址
可选
networkType
Tinyint
网络类型 0:未知 1:WIFI 2:2G 3:3G 4:4G 5:5G
可选
operatingSystem
String
操作系统
可选
phoneBrand
String
手机品牌
可选
phoneType
String
手机型号
可选
ramCanUse
String
ram可用
可选
ramTotal
String
ram总共
可选
rooted
String
是否root
可选
serial
String
硬件设备序列号
可选
systemVersions
String
系统版本
可选
useVpn
String
是否使用vpn 1:是 0:否
可选
versionCode
String
应用build号
可选
versionName
String
应用版本号
可选
wifiInfo
JSON
WIFI信息
可选
linkSpeed
String
连接速度
可选
mac
String
MAC地址
可选
ssid
String
SSID
可选
wifiIp
String
WIFI IP
可选

示例代码

``` { "appId": "XXXXX", "packageName": "in.XXXXX", "version": "1.0.4", "borrowId": "XXX", "transactionId": "33333", "userPhone":"3333333", "type": "device", "deviceInfo": { "androidId": "fb31ff6dc0642fad", "appInstallTime": 1590050047255, "batteryLevel": 100, "batteryStatus": 5, "cashCanUse": 104799830016, "cashTotal": 118495379456, "cellularNetworkIp": "fe80::44b:f6ff:fe15:c131%dummy0", "containSd": 1, "deviceHeight": 2232, "deviceLanguage": "zh", "deviceName": "HWYAL", "deviceTime": 1590055668544, "deviceWidth": 1080, "extraSd": 1, "gpsLatitude": 22.533015, "gpsLongitude": 113.947973, "imei": "fb31ff6dc0642fad", "isSimulator": 0, "isp": "", "mac": "D8:8A:DC:7F:6C:F3", "networkType": 1, "operatingSystem": "Android", "phoneBrand": "HONOR", "phoneType": "YAL-AL10", "productionDate": 1585024805000, "ramCanUse": 4478488576, "ramTotal": 7991095296, "rooted": 0, "sdkVersion": 29, "securityPatch": 0, "serial": "unknown", "systemVersions": 29, "useVpn": 0, "versionCode": 104, "versionName": "1.0.4", "wifiInfo": { "linkSpeed": 150, "mac": "02:00:00:00:00:00", "ssid": "\"XXXXXXXX\"" }, "wifiIp": "192.168.5.120" } } ```

APP列表

参数名
类型
描述
必填
appId
String
商户唯一标识
必填
packageName
String
包名
必填
version
String
app版本
必填
borrowId
String
订单标识
必填
transactionId
String
唯一数据识别号,可使用机构用户ID
必填
userPhone
String
用户手机号码
必填
type
String
固定填写 app
必填
installedApps
JSONArray
app 安装列表
必填
appName
String
app名称
必填
appPackageName
String
app包名
必填
appVersionCode
String
版本代码
必填
installTime
String
app安装时间
必填
upgradeTime
String
app更新时间
必填

示例代码

``` { "appId": "XXXXX", "packageName": "in.XXXXX", "version": "1.0.4", "borrowId": "XXX", "transactionId": "33333", "userPhone":"3333333", "type": "app", "installedApps": [{ "appName": "YouTube", "appPackageName": "com.google.android.youtube", "appVersionCode": "15.19.34", "installTime": 1586851294257, "upgradeTime": 0 }, { "appName": "Google", "appPackageName": "com.google.android.googlequicksearchbox", "appVersionCode": "11.9.16.21.arm64", "installTime": 1588747225427, "upgradeTime": 0 }] } ```

联系人列表

参数名
类型
描述
必填
appId
Sting
商户唯一标识
必填
packageName
Sting
包名
必填
version
Sting
app版本
必填
borrowId
Sting
订单标识
必填
transactionId
String
唯一数据识别号,可使用机构用户ID
必填
userPhone
String
用户手机号码
必填
type
Sting
固定填写 contact
必填
contacts
JSONArray
联系人列表
必填
name
Sting
联系人姓名
必填
phone
Sting
联系人手机号
必填

示例代码

``` { "appId": "XXXXX", "packageName": "in.XXXXX", "version": "1.0.4", "borrowId": "XXX", "transactionId": "33333", "userPhone":"3333333", "type": "contact", "contacts": [{ "name": "小明", "phone": "152 1111 1222" }, { "name": "灵", "phone": "136 3139 5596" }, { "name": "测试一", "phone": "15412345678" }] } ```

短信列表

参数名
类型
描述
必填
appId
Sting
商户唯一标识
必填
packageName
Sting
包名
必填
version
Sting
app版本
必填
borrowId
Sting
用户id
必填
transactionId
Sting
唯一数据识别号,可使用机构用户ID
必填
userPhone
String
用户手机号码
必填
type
Sting
固定填写 msg
必填
messageInfos
JSONArray
必填
name
Sting
短信收发人
必填
phone
Sting
手机号码
必填
type
Sting
收发标识 1-发送 2-接收
必填
time
Sting
收发时间
必填
msg
Sting
短信内容
必填

示例代码

``` { "appId": "XXXXX", "packageName": "in.XXXXX", "version": "1.0.4", "borrowId": "XXX", "transactionId": "33333", "userPhone":"3333333", "type": "msg", "contacts": [{ "name": "10010011", "phone": "10010011", "type": "20", "time": "1586674169565", "msg": "xxxx" }, { "name": "10010011", "phone": "10010011", "type": "20", "time": "1586674169565", "msg": "xxxx" },] } ```

照片信息

参数名
类型
描述
必填
appId
String
商户唯一标识
必填
packageName
String
包名
必填
version
String
APP版本
必填
borrowId
String
订单标识
必填
transactionId
String
唯一数据识别号,可使用机构用户ID
必填
userPhone
String
用户手机号码
必填
type
String
固定填写 img
必填
imgInfoBeans
JSONArray
必填
width
String
照片宽度
必填
height
String
照片高度
必填
name
String
文件名
必填

示例代码

``` { "appId": "XXXXX", "packageName": "in.XXXXX", "version": "1.0.4", "borrowId": "XXX", "transactionId": "33333", "userPhone":"3333333", "type": "img", "imgInfoBeans": [{ "name": "mmexport1500730656148.jpg", "width": "337", "height": "800" },{ "mode": "xxx", "name": "mmexport1500730656148.jpg", "width": "337", "height": "800" }] } ```

响应参数

参数名
类型
描述
必填
code
Int
响应码 200 为发送成功
必填
msg
String
提示信息
必填