跳转到主要内容
1签 (OneSign)

OverflowDeviceList

本页内容

当前应用的超限设备列表。区分仍待处理和已恢复的记录,结合当次安装上限解释结果。

如何阅读本模型

先从下方相关接口确认该模型用于请求还是响应,再按字段层级读取。请求模型由调用方填写,响应模型由平台返回;同名字段在不同模型中可能含义不同。

应用、版本、任务和回执的区别见基本概念。需要一份可跟做的示例时,从相关接口进入对应产品指南。

字段定义

“必需”指字段所在的对象出现时,该字段是否必须存在。类型中含 null 表示值允许为空;未返回、null、空字符串和零分别处理。

字段必需说明
app_id 是

业务应用的完整 ID,来自列出应用或预留新应用的响应。

类型:string

查看取值约束
  • 格式 ^A[a-f0-9]{32}$
generated_at 是

本次结果的生成时间,Unix 秒。

类型:integer

查看取值约束
  • 最小值 0
  • 最大值 9007199254740991
source 是

设备明细的数据来源,devices 为已登记设备,overflow 为超限记录。

类型:string

查看取值约束
  • 固定值 overflow
device_identifier 是

设备标识的来源和口径,为应用内统计标识。

类型:string

查看取值约束
  • 固定值 retained_installation_identifier_not_hardware_attestation
network_visible 是

本次授权是否允许查看 IP 和地区。

类型:boolean

consistency 是

分页数据的一致性口径。实时留存记录可能在翻页期间发生变化。

类型:string

查看取值约束
  • 固定值 live_retained_records
legacy_launches_may_exclude_first_open 是

历史启动次数是否可能缺少首次打开。

类型:boolean

查看取值约束
  • 固定值 true
items 是

与当前请求条件匹配的记录。数组元素的字段见下方各行。

类型:object[]

查看取值约束
  • 最多元素 100
items[].device_id 是

应用上报并由平台留存的设备标识,用于安装统计和游标查询。

类型:string

查看取值约束
  • 格式 ^F(?:[a-f0-9]{24,64}|[a-f0-9]{8}-[a-f0-9]{16}|instance:[a-f0-9]{40})$
items[].ip 是

获准访问的设备网络 IP。用作筛选条件时需要网络字段权限。

类型:string | null

查看取值约束
  • 最多字符 45
items[].region 是

平台记录的网络地区。用作筛选条件时需要网络字段权限。

类型:string | null

查看取值约束
  • 最多字符 255
items[].first_denied_at 是

首次因安装量超限而被拒绝的时间,Unix 秒。

类型:integer

查看取值约束
  • 最小值 0
  • 最大值 9007199254740991
items[].last_denied_at 是

最近一次超限拒绝的时间,Unix 秒。

类型:integer

查看取值约束
  • 最小值 0
  • 最大值 9007199254740991
items[].attempts 是

该设备因超限被拒绝的累计尝试次数。

类型:integer

查看取值约束
  • 最小值 0
  • 最大值 9007199254740991
items[].last_install_limit 是

最近一次拒绝时的安装量上限。

类型:integer

查看取值约束
  • 最小值 0
  • 最大值 9007199254740991
items[].admitted_at 是

恢复准入的时间,Unix 秒。空值表示暂无恢复记录。

类型:integer

查看取值约束
  • 最小值 0
  • 最大值 9007199254740991
items[].state 是

当前记录的处理状态或请求筛选的状态。

类型:string

查看取值约束
  • 可选值 pending / recovered
  • pending — 尚未恢复准入
  • recovered — 已恢复准入
next_cursor 是

传给下一次请求的 cursor。为 null 表示已到末页。

类型:string | null

查看取值约束
  • string (格式 ^F(?:[a-f0-9]{24,64}|[a-f0-9]{8}-[a-f0-9]{16}|instance:[a-f0-9]{40})$)

相关接口

下面根据接口定义列出使用本模型的操作,包括嵌套在其他对象中的情况。接口示例展示完整请求和响应;模型本身不会增加任何权限。

作为成功响应