邀请
查询邀请功能开通状态,以及在满足累计套餐天数条件后自助申请开通邀请功能。
邀请接口均属于管理接口:鉴权方式为登录会话(或用户 access token)+ Jimu-Api-User 请求头,
不接受 sk- API 令牌本身,详见 鉴权与令牌。
错误响应为管理接口形态(success/message),见 错误处理与请求追踪。
积木的邀请功能默认对新用户关闭,需要累计订阅套餐达到一定天数后自助申请,管理员审核通过才能获得邀请资格。 本页只覆盖用户侧的状态查询与申请提交;审批由管理员在后台完成,不提供公开接口。
| 方法 | 路径 | 说明 |
|---|---|---|
GET | /api/user/self/invitation/status | 查询本人邀请资格状态与申请条件 |
POST | /api/user/self/invitation/apply | 提交邀请功能开通申请 |
查询邀请状态
GET
/api/user/self/invitation/status无需参数。
响应200
{
"success": true,
"message": "",
"data": {
"accumulated_package_days": 45,
"invitation_enabled": false,
"invitation_enabled_time": 0,
"invitation_required_days": 30,
"can_apply": true,
"has_pending_application": false
}
}
accumulated_package_daysint累计订阅套餐天数(跨多次续费/兑换累加)
invitation_enabledbool是否已获得邀请资格
invitation_enabled_timeint邀请资格开通时间(Unix 秒);未开通时为 0
invitation_required_daysint申请所需的累计套餐天数门槛(站点可配置,默认 30)
can_applybool当前是否满足申请条件(累计天数达标且尚未获得资格)
has_pending_applicationbool是否已有一条待审核的申请
提交申请
POST
/api/user/self/invitation/apply无需请求体参数。提交前需满足:累计套餐天数 ≥ invitation_required_days、尚未获得邀请资格、且没有待审核的申请中记录。
成功200
{ "success": true, "message": "申请已提交,请等待管理员审核" }
不满足条件时返回 success: false,message 说明具体原因:
| 场景 | message |
|---|---|
| 累计天数不足 | 累计套餐天数不足,需要{N}天,当前{M}天 |
| 已获得邀请资格 | 邀请功能已启用,无需申请 |
| 已有待审核申请 | 已有待审核的申请,请等待管理员处理 |
申请提交后进入待审核状态,由管理员在后台批准或拒绝,审批结果不通过接口主动推送,
需要再次调用查询接口自行轮询
invitation_enabled 与 has_pending_application。