SigningEntitlement
本页内容
应用当前的签名权益快照,包括有效期、证书状态、安装限制和获准统计。提交签名时仍会重新核对资格。
如何阅读本模型
先从下方相关接口确认该模型用于请求还是响应,再按字段层级读取。请求模型由调用方填写,响应模型由平台返回;同名字段在不同模型中可能含义不同。
应用、版本、任务和回执的区别见基本概念。需要一份可跟做的示例时,从相关接口进入对应产品指南。
字段定义
“必需”指字段所在的对象出现时,该字段是否必须存在。类型中含 null 表示值允许为空;未返回、null、空字符串和零分别处理。
| 字段 | 必需 | 说明 |
|---|---|---|
app_id |
是 | 当前账号授权的企业签名应用。 查看取值约束
|
generated_at |
是 | 查询时刻 UTC 秒,权益和准入仍会在后续写入时重新核实。 查看取值约束
|
state |
是 | not_activated 未开通、active 有效、expired 已到期;该状态不代表一定可以成功提交任务。 查看取值约束
|
plan_id |
是 | 当前套餐编号,0 未分类、1 基础版、2 高级版、3 独立版。 查看取值约束
|
plan_name |
是 | 当前套餐展示名称。 |
sign_expires_at |
是 | 当前签名有效期到期 UTC 秒;0 表示未开通。 查看取值约束
|
remaining_seconds |
是 | 距到期的剩余秒数,不小于零。 查看取值约束
|
first_recorded_activation_at |
是 | 当前权益台账中最早记录的开通时刻;缺失为 null,不能拿上传时间代替。 查看取值约束
|
application_status |
是 | normal 正常、pending_review 待审核、blocked 被锁定。 查看取值约束
|
certificate |
是 | 当前已分配的同套餐证书公开信息;缺失、重复或套餐不符为 null。 |
certificate.id |
是 | 该条记录的公开标识。调用后续接口时请完整保留,包括前缀。 查看取值约束
|
certificate.label |
是 | 用于选择和区分证书的公开备注。 查看取值约束
|
certificate.team |
是 | 证书对应的团队信息。 查看取值约束
|
certificate.certificate_expires |
是 | 证书本身的到期时间文本,不是签名套餐的到期时间。 查看取值约束
|
certificate.profile_expires |
是 | 描述文件本身的到期时间文本。 查看取值约束
|
certificate.selected |
是 | 此证书是否为当前应用已选用的证书。 |
certificate_state |
是 | assigned 当前已分配同套餐证书的公开信息;unavailable 表示缺失、重复或套餐不匹配。 查看取值约束
|
installation_limit |
是 | 应用级安装量上限与跨版本去重规则。 |
installation_limit.maximum_devices |
是 | 应用级唯一设备上限,0 表示不限;不逐版本重复计费。 查看取值约束
|
installation_limit.unlimited |
是 | 上限为 0 时为 true。 |
installation_limit.cross_version_deduplicated |
是 | 同一应用跨版本按设备指纹去重,不是系统真实 UDID。 查看取值约束
|
verification |
是 | 后续签名使用的验证库与等待提示配置,不代表当前安装包授权结果。 |
verification.injection_enabled |
是 | 后续签名是否注入平台验证库;不是授权通过状态。 |
verification.ui_mode |
是 | 后续签名生效的等待提示方案,不改变授权、到期和安装量规则。 查看取值约束
|
verification.ui_inherited |
是 | 是否跟随全局默认验证提示方式。 |
verification.applies_to_next_signature |
是 | 上述配置用于后续签名,不能据此推断已有安装包所带配置。 查看取值约束
|
refund_policy |
是 | 网站当前全局退款政策;实际退款资格须查询指定原 API 订单。 |
refund_policy.window_seconds |
是 | 当前全局余额订单退款窗口,仍需查询指定 API 订单资格。 查看取值约束
|
refund_policy.daily_supported |
是 | 当前按天余额订单是否支持退款。 |
refund_policy.redemption_supported |
是 | 密钥开通固定不支持退款。 查看取值约束
|
refund_policy.other_rules_apply |
是 | 还需满足来源 API 应用、次数、安装量等退款规则;不是退款资格承诺。 查看取值约束
|
statistics_state |
是 | available 已按统计权限返回,not_authorized 未授统计动作,disabled 账号未批准统计,unavailable 统计暂不可用或被限流。 查看取值约束
|
statistics |
是 | 同时获统计动作与账号统计审批时返回现有统计结构;否则为 null,不能当作零。 |
statistics.app_id |
是 | 业务应用的完整 ID,来自列出应用或预留新应用的响应。 查看取值约束
|
statistics.module |
是 | 业务模块。enterprise 为企业签名,distribution 为普通应用分发。 查看取值约束
|
statistics.generated_at |
是 | 本次结果的生成时间,Unix 秒。 查看取值约束
|
statistics.timezone |
是 | 统计日期或预算周期采用的时区。 查看取值约束
|
statistics.record_scope |
是 | 数据覆盖的留存范围。 查看取值约束
|
statistics.window |
是 | 本次统计覆盖的日期和时间区间。 |
statistics.window.start_date |
是 | 区间首日,按响应中的 timezone 解释。 查看取值约束
|
statistics.window.end_date |
是 | 区间末日,按响应中的 timezone 解释。 查看取值约束
|
statistics.window.start_at |
是 | 时间区间起点,Unix 秒。 查看取值约束
|
statistics.window.end_at |
是 | 时间区间边界,Unix 秒。 查看取值约束
|
statistics.downloads |
是 | 平台已准入的下载计数。 |
statistics.downloads.unit |
是 | 此金额或计数的单位,结合所在对象解释。 查看取值约束
|
statistics.downloads.total |
是 | 当前保留范围内的累计数量。 查看取值约束
|
statistics.downloads.today |
是 | 统计时区内今日的数量。 查看取值约束
|
statistics.downloads.yesterday |
是 | 统计时区内昨日的数量。 查看取值约束
|
statistics.downloads.last_7_days |
是 | 近 7 个自然日的数量。 查看取值约束
|
statistics.downloads.last_30_days |
是 | 近 30 个自然日的数量。 查看取值约束
|
statistics.installation_statistics_state |
是 | available 表示有数据,not_initialized 为未初始化,not_applicable 为此模块不适用。 查看取值约束
|
statistics.installations |
是 | 应用级安装设备统计。按返回口径跨版本去重,不能由各版本计数相加替代。 |
statistics.installations.unit |
是 | 此金额或计数的单位,结合所在对象解释。 查看取值约束
|
statistics.installations.total |
是 | 当前保留范围内的累计数量。 查看取值约束
|
statistics.installations.today |
是 | 统计时区内今日的数量。 查看取值约束
|
statistics.installations.yesterday |
是 | 统计时区内昨日的数量。 查看取值约束
|
statistics.installations.last_7_days |
是 | 近 7 个自然日的数量。 查看取值约束
|
statistics.installations.last_30_days |
是 | 近 30 个自然日的数量。 查看取值约束
|
statistics.installations.cross_version_deduplicated |
是 | 是否已经跨版本按同一设备去重。 查看取值约束
|
statistics.launches |
是 | 记录到的设备启动事件次数,按返回口径解释。 |
statistics.launches.unit |
是 | 此金额或计数的单位,结合所在对象解释。 查看取值约束
|
statistics.launches.total |
是 | 当前保留范围内的累计数量。 查看取值约束
|
statistics.launches.today |
是 | 统计时区内今日的数量。 查看取值约束
|
statistics.launches.today_estimated |
是 | 今日计数是否为历史兼容估计值。 |
statistics.launches.current_rules_include_first_open |
是 | 当前启动计数规则是否包含首次打开。 查看取值约束
|
statistics.launches.legacy_totals_may_exclude_first_open |
是 | 旧版累计计数是否可能缺少首次打开。 查看取值约束
|
statistics.daily |
是 | 本次统计窗口内的逐日计数,按返回的 timezone 解释日期。 查看取值约束
|
statistics.daily[].date |
是 | 本条统计对应的自然日。 查看取值约束
|
statistics.daily[].downloads |
是 | 平台已准入的下载计数。 查看取值约束
|
statistics.daily[].new_installations |
是 | 该自然日新增的安装设备数。 查看取值约束
|
signing_admission_rechecked |
是 | 后续任务将重新检查期限、账号、应用、证书、源版本及并发/每日额度,当前详情不预留资格。 查看取值约束
|
相关接口
下面根据接口定义列出使用本模型的操作,包括嵌套在其他对象中的情况。接口示例展示完整请求和响应;模型本身不会增加任何权限。