苹果订阅
请求URL:
/appleSubscribe
请求方式:
- POST
参数:
| 参数名 | 必选 | 类型 | 说明 |
|---|---|---|---|
| appId | 是 | string | 应用包appId |
| udid | 是 | string | 设备ID |
| sign | 是 | string | 接口签名 |
| receiptData | 是 | string | 订阅凭证 |
| productId | 是 | string | 订阅项ID |
| isSubSign | 否 | uint8 | 是否签到领奖励版订阅:0-否;1-是(仅套餐 type=8/9 生效) |
请求示例:
{
"appId": "your-app-id",
"udid": "device-id",
"sign": "request-sign",
"receiptData": "apple-subscription-receipt",
"productId": "sign_week",
"isSubSign": 1
}
App Store 订阅是真实商店订阅,请求不传
subPkg,订单中sub_pkg固定记录为0。isSubSign会按实际套餐类型归一化后写入订单。
返回示例
{
"code": 200,
"msg": "SUCCESS",
"data": null
}
返回参数说明
| 参数名 | 类型 | 说明 |
|---|---|---|
| code | int | 状态码 |
| msg | string | 提示信息 |
| data | struct | 数据列表 |
部分状态码一览
| 类目 | 编码 |
|---|---|
| 1000 | 支付验证失败 |
| 1010 | 支付重复核验 |
| 1020 | 支付产品验证失败 |
| 1100 | 无效的小票 |
| 2010 | 订阅已过期 |
| 2020 | 订阅已取消 |
建议 状态码为 1010 1020 1100 2010 2020 就丢弃小票
签到版订阅说明
- 仅当
isSubSign=1且实际购买套餐的type为8或9时,才按签到版订阅处理,订阅记录和订单均写入is_sub_sign=1。 - 验证成功后本接口只初始化签到权益,不立即下发套餐钻石;用户需调用
/subSignIn按日领取奖励。 - 每次购买会按真实
type生成一批独立权益;后续按购买顺序先领旧权益,再领新权益。 - 签到版订阅不会参与普通订阅的定时赠送钻石任务。
isSubSign=1但套餐非type=8/9时仍按普通订阅处理。