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

PurchaseEntitlement

本页内容

购买成功后获得的业务权益。按 scope 解释签名时长、下载点数或会员权益,开通与后续签名分别确认。

如何阅读本模型

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

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

字段定义

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

字段必需说明
scope 是

权益归属范围,application 为指定应用,account 为账号。

类型:string

查看取值约束
  • 可选值 application / account
sign_expires_at 是

签名权益的到期时间,Unix 秒。

类型:integer | null

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

权益对应的签名套餐编号。

类型:integer | null

查看取值约束
  • integer (可选值 1 / 2 / 3)
download_points 是

账号分发下载点数。

类型:integer | null

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

站内会员等级。

类型:integer | null

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

会员权益到期时间,Unix 秒。

类型:integer | null

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

相关接口

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

作为成功响应