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

SigningEntitlement

本页内容

应用当前的签名权益快照,包括有效期、证书状态、安装限制和获准统计。提交签名时仍会重新核对资格。

如何阅读本模型

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

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

字段定义

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

字段必需说明
app_id 是

当前账号授权的企业签名应用。

类型:string

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

查询时刻 UTC 秒,权益和准入仍会在后续写入时重新核实。

类型:integer

查看取值约束
  • 最小值 0
state 是

not_activated 未开通、active 有效、expired 已到期;该状态不代表一定可以成功提交任务。

类型:string

查看取值约束
  • 可选值 not_activated / active / expired
  • active — 有效
  • expired — 已过期
plan_id 是

当前套餐编号,0 未分类、1 基础版、2 高级版、3 独立版。

类型:integer

查看取值约束
  • 最小值 0
plan_name 是

当前套餐展示名称。

类型:string

sign_expires_at 是

当前签名有效期到期 UTC 秒;0 表示未开通。

类型:integer

查看取值约束
  • 最小值 0
remaining_seconds 是

距到期的剩余秒数,不小于零。

类型:integer

查看取值约束
  • 最小值 0
first_recorded_activation_at 是

当前权益台账中最早记录的开通时刻;缺失为 null,不能拿上传时间代替。

类型:integer | null

查看取值约束
  • integer (最小值 0)
application_status 是

normal 正常、pending_review 待审核、blocked 被锁定。

类型:string

查看取值约束
  • 可选值 normal / pending_review / blocked
certificate 是

当前已分配的同套餐证书公开信息;缺失、重复或套餐不符为 null。

类型:object | null

certificate.id 是

该条记录的公开标识。调用后续接口时请完整保留,包括前缀。

类型:string

查看取值约束
  • 格式 ^C[a-f0-9]{32}$
certificate.label 是

用于选择和区分证书的公开备注。

类型:string

查看取值约束
  • 最多字符 255
certificate.team 是

证书对应的团队信息。

类型:string

查看取值约束
  • 最多字符 255
certificate.certificate_expires 是

证书本身的到期时间文本,不是签名套餐的到期时间。

类型:string

查看取值约束
  • 最多字符 80
certificate.profile_expires 是

描述文件本身的到期时间文本。

类型:string

查看取值约束
  • 最多字符 80
certificate.selected 是

此证书是否为当前应用已选用的证书。

类型:boolean

certificate_state 是

assigned 当前已分配同套餐证书的公开信息;unavailable 表示缺失、重复或套餐不匹配。

类型:string

查看取值约束
  • 可选值 assigned / unavailable
installation_limit 是

应用级安装量上限与跨版本去重规则。

类型:object

installation_limit.maximum_devices 是

应用级唯一设备上限,0 表示不限;不逐版本重复计费。

类型:integer

查看取值约束
  • 最小值 0
installation_limit.unlimited 是

上限为 0 时为 true。

类型:boolean

installation_limit.cross_version_deduplicated 是

同一应用跨版本按设备指纹去重,不是系统真实 UDID。

类型:boolean

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

后续签名使用的验证库与等待提示配置,不代表当前安装包授权结果。

类型:object

verification.injection_enabled 是

后续签名是否注入平台验证库;不是授权通过状态。

类型:boolean

verification.ui_mode 是

后续签名生效的等待提示方案,不改变授权、到期和安装量规则。

类型:integer

查看取值约束
  • 可选值 1 / 2 / 3
verification.ui_inherited 是

是否跟随全局默认验证提示方式。

类型:boolean

verification.applies_to_next_signature 是

上述配置用于后续签名,不能据此推断已有安装包所带配置。

类型:boolean

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

网站当前全局退款政策;实际退款资格须查询指定原 API 订单。

类型:object

refund_policy.window_seconds 是

当前全局余额订单退款窗口,仍需查询指定 API 订单资格。

类型:integer

查看取值约束
  • 最小值 0
refund_policy.daily_supported 是

当前按天余额订单是否支持退款。

类型:boolean

refund_policy.redemption_supported 是

密钥开通固定不支持退款。

类型:boolean

查看取值约束
  • 固定值 false
refund_policy.other_rules_apply 是

还需满足来源 API 应用、次数、安装量等退款规则;不是退款资格承诺。

类型:boolean

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

available 已按统计权限返回,not_authorized 未授统计动作,disabled 账号未批准统计,unavailable 统计暂不可用或被限流。

类型:string

查看取值约束
  • 可选值 available / not_authorized / disabled / unavailable
statistics 是

同时获统计动作与账号统计审批时返回现有统计结构;否则为 null,不能当作零。

类型:object | null

statistics.app_id 是

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

类型:string

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

业务模块。enterprise 为企业签名,distribution 为普通应用分发。

类型:string

查看取值约束
  • 可选值 enterprise / distribution
  • enterprise — 企业签名
  • distribution — 普通应用分发
statistics.generated_at 是

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

类型:integer

查看取值约束
  • 最小值 0
  • 最大值 9007199254740991
statistics.timezone 是

统计日期或预算周期采用的时区。

类型:string

查看取值约束
  • 固定值 Asia/Shanghai
statistics.record_scope 是

数据覆盖的留存范围。

类型:string

查看取值约束
  • 固定值 current_retained_counters
statistics.window 是

本次统计覆盖的日期和时间区间。

类型:object

statistics.window.start_date 是

区间首日,按响应中的 timezone 解释。

类型:string

查看取值约束
  • 格式 ^\d{4}-\d{2}-\d{2}$
statistics.window.end_date 是

区间末日,按响应中的 timezone 解释。

类型:string

查看取值约束
  • 格式 ^\d{4}-\d{2}-\d{2}$
statistics.window.start_at 是

时间区间起点,Unix 秒。

类型:integer

查看取值约束
  • 最小值 0
  • 最大值 9007199254740991
statistics.window.end_at 是

时间区间边界,Unix 秒。

类型:integer

查看取值约束
  • 最小值 0
  • 最大值 9007199254740991
statistics.downloads 是

平台已准入的下载计数。

类型:object

statistics.downloads.unit 是

此金额或计数的单位,结合所在对象解释。

类型:string

查看取值约束
  • 固定值 admitted_downloads
statistics.downloads.total 是

当前保留范围内的累计数量。

类型:integer

查看取值约束
  • 最小值 0
  • 最大值 9007199254740991
statistics.downloads.today 是

统计时区内今日的数量。

类型:integer

查看取值约束
  • 最小值 0
  • 最大值 9007199254740991
statistics.downloads.yesterday 是

统计时区内昨日的数量。

类型:integer

查看取值约束
  • 最小值 0
  • 最大值 9007199254740991
statistics.downloads.last_7_days 是

近 7 个自然日的数量。

类型:integer

查看取值约束
  • 最小值 0
  • 最大值 9007199254740991
statistics.downloads.last_30_days 是

近 30 个自然日的数量。

类型:integer

查看取值约束
  • 最小值 0
  • 最大值 9007199254740991
statistics.installation_statistics_state 是

available 表示有数据,not_initialized 为未初始化,not_applicable 为此模块不适用。

类型:string

查看取值约束
  • 可选值 available / not_initialized / not_applicable
  • available — 计数可用
  • not_initialized — 尚未初始化
  • not_applicable — 此类应用不适用
statistics.installations 是

应用级安装设备统计。按返回口径跨版本去重,不能由各版本计数相加替代。

类型:object | null

statistics.installations.unit 是

此金额或计数的单位,结合所在对象解释。

类型:string

查看取值约束
  • 固定值 unique_admitted_device_fingerprints
statistics.installations.total 是

当前保留范围内的累计数量。

类型:integer

查看取值约束
  • 最小值 0
  • 最大值 9007199254740991
statistics.installations.today 是

统计时区内今日的数量。

类型:integer

查看取值约束
  • 最小值 0
  • 最大值 9007199254740991
statistics.installations.yesterday 是

统计时区内昨日的数量。

类型:integer

查看取值约束
  • 最小值 0
  • 最大值 9007199254740991
statistics.installations.last_7_days 是

近 7 个自然日的数量。

类型:integer

查看取值约束
  • 最小值 0
  • 最大值 9007199254740991
statistics.installations.last_30_days 是

近 30 个自然日的数量。

类型:integer

查看取值约束
  • 最小值 0
  • 最大值 9007199254740991
statistics.installations.cross_version_deduplicated 是

是否已经跨版本按同一设备去重。

类型:boolean

查看取值约束
  • 固定值 true
statistics.launches 是

记录到的设备启动事件次数,按返回口径解释。

类型:object | null

statistics.launches.unit 是

此金额或计数的单位,结合所在对象解释。

类型:string

查看取值约束
  • 固定值 recorded_launch_events
statistics.launches.total 是

当前保留范围内的累计数量。

类型:integer

查看取值约束
  • 最小值 0
  • 最大值 9007199254740991
statistics.launches.today 是

统计时区内今日的数量。

类型:integer

查看取值约束
  • 最小值 0
  • 最大值 9007199254740991
statistics.launches.today_estimated 是

今日计数是否为历史兼容估计值。

类型:boolean

statistics.launches.current_rules_include_first_open 是

当前启动计数规则是否包含首次打开。

类型:boolean

查看取值约束
  • 固定值 true
statistics.launches.legacy_totals_may_exclude_first_open 是

旧版累计计数是否可能缺少首次打开。

类型:boolean

查看取值约束
  • 固定值 true
statistics.daily 是

本次统计窗口内的逐日计数,按返回的 timezone 解释日期。

类型:object[]

查看取值约束
  • 最少元素 30
  • 最多元素 30
statistics.daily[].date 是

本条统计对应的自然日。

类型:string

查看取值约束
  • 格式 ^\d{4}-\d{2}-\d{2}$
statistics.daily[].downloads 是

平台已准入的下载计数。

类型:integer

查看取值约束
  • 最小值 0
  • 最大值 9007199254740991
statistics.daily[].new_installations 是

该自然日新增的安装设备数。

类型:integer | null

查看取值约束
  • integer (最小值 0,最大值 9007199254740991)
signing_admission_rechecked 是

后续任务将重新检查期限、账号、应用、证书、源版本及并发/每日额度,当前详情不预留资格。

类型:boolean

查看取值约束
  • 固定值 true

相关接口

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

作为成功响应