Table of Contents
7.17.1 我的福利数量【已开发,待登录态联调】
GET /tieup/api/v1/me/benefits/count
Authorization: Bearer <access_token>
鉴权:需要 Authorization: Bearer <access_token>。接口无路径参数、查询参数和请求体,服务端按 Token 中的 current_identity 返回当前使用端对应的福利数量。
统计口径:
- 粉丝身份只返回
redeemable_count。统计范围仅包含当前粉丝tieup_subscription.status=1且expires_at晚于当前时间的有效订阅艺人,并按艺人去重。 - 粉丝可兑换数量只统计当前上架、未软删除、库存充足、尚无待发放或已发放兑换记录,并且按历史累计订阅月数、提问数、视频通话分钟数或糖果消费数已经达标的福利。
- 偶像身份只返回
pending_count。统计当前偶像全部tieup_benefit_redemption.status=1的待发放记录,关联福利后续下架或软删除仍计入。 - 数量是查询时的实时入口提示。提交兑换和发放时仍以对应写接口的事务、库存、状态与归属校验结果为准。
粉丝身份完整响应示例:
{
"code": 200,
"message": "成功",
"data": {
"redeemable_count": 3
}
}
偶像身份完整响应示例:
{
"code": 200,
"message": "成功",
"data": {
"pending_count": 2
}
}
响应字段:
| 字段 | 类型 | 返回身份 | 说明 |
|---|---|---|---|
code |
integer | 粉丝、偶像 | 业务响应码,成功为 200 |
message |
string | 粉丝、偶像 | 响应信息,成功为 成功 |
data |
object | 粉丝、偶像 | 当前身份对应的福利数量对象 |
data.redeemable_count |
integer | 仅粉丝 | 当前有效订阅艺人下所有可兑换福利总数;无符合记录时返回 0 |
data.pending_count |
integer | 仅偶像 | 当前偶像全部历史待发放福利总数;无符合记录时返回 0 |
错误响应:
| HTTP/业务码 | 场景 | 说明 |
|---|---|---|
401 |
Token 缺失、无效或过期 | 返回统一鉴权失败响应 |
403 |
Token 选择偶像身份,但账号未开通偶像端或缺少艺人档案 | 返回 当前账号未开通偶像端 |