邀请

查询邀请功能开通状态,以及在满足累计套餐天数条件后自助申请开通邀请功能。

邀请接口均属于管理接口:鉴权方式为登录会话(或用户 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。