# Ai Forge

## Docs
- 根目录 [API接口使用说明](https://s.apifox.cn/beffd1da-1021-434c-8f13-8cbf50a3f406/9358897m0.md): 
- 根目录 > 微信公众号 [接口使用说明](https://s.apifox.cn/beffd1da-1021-434c-8f13-8cbf50a3f406/9354785m0.md): 

## API Docs
- 根目录 > V1 > 公共接口 [重载 FPM/OPcache](https://s.apifox.cn/beffd1da-1021-434c-8f13-8cbf50a3f406/504495657e0.md): 重置 OPcache 缓存。无请求参数。
- 根目录 > V1 > 公共接口 [发送邮件验证码](https://s.apifox.cn/beffd1da-1021-434c-8f13-8cbf50a3f406/504499338e0.md): 向指定邮箱发送验证码邮件。
- 根目录 > V1 > 公共接口 [发送短信验证码](https://s.apifox.cn/beffd1da-1021-434c-8f13-8cbf50a3f406/504499336e0.md): 向指定手机号发送短信验证码。受同 IP 与同号码发送频率限制（SmsCaptchaSendCheckRule）。
- 根目录 > V1 > 公共接口 [获取地区列表](https://s.apifox.cn/beffd1da-1021-434c-8f13-8cbf50a3f406/504499342e0.md): 按父级获取行政区划列表。不传 area_id 时返回顶级省份。响应带公共缓存头（max_age=2628000, etag）。
- 根目录 > V1 > 公共接口 [获取公开字典项列表](https://s.apifox.cn/beffd1da-1021-434c-8f13-8cbf50a3f406/505527686e0.md): 按字典编码获取启用的字典项列表，供前端下拉选项/标签渲染使用。采用白名单机制，仅允许访问前端需要的公开字典（当前支持：feedback_type）。响应带 HTTP 缓存头（Cache-Control: public, max-age=2628000, ETag），服务端同时使用 Redis 缓存 2 小时。
- 根目录 > V1 > 公共接口 [检查版本更新](https://s.apifox.cn/beffd1da-1021-434c-8f13-8cbf50a3f406/505844105e0.md): 检查指定平台和应用的版本更新信息
- 根目录 > V1 > 用户注册 [检查账号是否存在](https://s.apifox.cn/beffd1da-1021-434c-8f13-8cbf50a3f406/504499344e0.md): 检查用户名、邮箱或手机号是否已被占用（含已软删除用户）。三者至少传一个。
- 根目录 > V1 > 用户注册 [邮箱注册](https://s.apifox.cn/beffd1da-1021-434c-8f13-8cbf50a3f406/504499347e0.md): 使用邮箱与密码注册账号，成功后直接返回访问令牌。限流 10 次/3 分钟，另受 user.register_throttle 设置限制。
- 根目录 > V1 > 用户注册 [手机号注册](https://s.apifox.cn/beffd1da-1021-434c-8f13-8cbf50a3f406/504499349e0.md): 使用手机号加短信验证码注册账号，成功后直接返回访问令牌。限流 10 次/3 分钟。
- 根目录 > V1 > 认证授权 [账号密码登录](https://s.apifox.cn/beffd1da-1021-434c-8f13-8cbf50a3f406/504499351e0.md): 使用账号（用户名/邮箱/手机号）与密码登录。限流 10 次/3 分钟，另受 user.login_throttle 设置限制。被冻结用户会被清空全部令牌并拒绝登录。
- 根目录 > V1 > 认证授权 [微信公众号登录](https://s.apifox.cn/beffd1da-1021-434c-8f13-8cbf50a3f406/504811008e0.md): 使用微信公众号网页授权回调的 code 登录。服务端通过 code 换取用户 openid，仅当该 openid 已绑定用户时允许登录（不会自动注册），登录成功后会刷新本次授权的凭证（unionid、access_token、refresh_token、过期时间）。
- 根目录 > V1 > 认证授权 [苹果账号登录](https://s.apifox.cn/beffd1da-1021-434c-8f13-8cbf50a3f406/504811084e0.md): 使用 Apple 登录（Sign in with Apple）授权信息登录。服务端会用 authorizationCode 向 Apple 换取 id_token 校验授权有效性，仅当 user_id 已绑定用户时允许登录（不会自动注册）。
- 根目录 > V1 > 认证授权 [短信验证码登录](https://s.apifox.cn/beffd1da-1021-434c-8f13-8cbf50a3f406/504499358e0.md): 使用手机号与短信验证码登录。若账号不存在且 user.enable_phone_login_register 为开启状态，会自动创建账号。限流 10 次/3 分钟。
- 根目录 > V1 > 认证授权 [短信验证码重置密码](https://s.apifox.cn/beffd1da-1021-434c-8f13-8cbf50a3f406/504499361e0.md): 通过手机号与短信验证码重置登录密码。重置成功后该用户的全部访问令牌都会被清除。
- 根目录 > V1 > 认证授权 [刷新访问令牌](https://s.apifox.cn/beffd1da-1021-434c-8f13-8cbf50a3f406/504499364e0.md): 基于当前令牌签发一个新令牌，旧令牌将在 1 分钟后被异步删除。被冻结用户会被清空全部令牌并拒绝刷新。
- 根目录 > V1 > 认证授权 [获取已签发令牌列表](https://s.apifox.cn/beffd1da-1021-434c-8f13-8cbf50a3f406/504499366e0.md): 分页获取当前用户已签发的全部个人访问令牌，按 ID 倒序。
- 根目录 > V1 > 认证授权 [退出登录](https://s.apifox.cn/beffd1da-1021-434c-8f13-8cbf50a3f406/504499372e0.md): 删除当前正在使用的访问令牌，使其立即失效。
- 根目录 > V1 > 认证授权 [销毁指定的 Token](https://s.apifox.cn/beffd1da-1021-434c-8f13-8cbf50a3f406/506347850e0.md): 
- 根目录 > V1 > 用户接口 > 用户通知 [获取通知列表](https://s.apifox.cn/beffd1da-1021-434c-8f13-8cbf50a3f406/504500063e0.md): 分页获取当前用户的全部通知，可按通知类型过滤。
- 根目录 > V1 > 用户接口 > 用户通知 [获取未读通知列表](https://s.apifox.cn/beffd1da-1021-434c-8f13-8cbf50a3f406/504500064e0.md): 分页获取当前用户的未读通知，可按通知类型过滤。
- 根目录 > V1 > 用户接口 > 用户通知 [标记全部通知已读](https://s.apifox.cn/beffd1da-1021-434c-8f13-8cbf50a3f406/504500068e0.md): 将当前用户的所有未读通知标记为已读。
- 根目录 > V1 > 用户接口 > 用户通知 [标记指定通知已读](https://s.apifox.cn/beffd1da-1021-434c-8f13-8cbf50a3f406/504500072e0.md): 将指定 ID 的未读通知标记为已读。
- 根目录 > V1 > 用户接口 > 用户通知 [清空已读通知](https://s.apifox.cn/beffd1da-1021-434c-8f13-8cbf50a3f406/504500076e0.md): 删除当前用户的全部已读通知。
- 根目录 > V1 > 用户接口 > 收货地址 [获取地址列表](https://s.apifox.cn/beffd1da-1021-434c-8f13-8cbf50a3f406/506150348e0.md): 分页获取当前用户的所有收货地址，默认按更新时间倒序排列。
- 根目录 > V1 > 用户接口 > 收货地址 [创建收货地址](https://s.apifox.cn/beffd1da-1021-434c-8f13-8cbf50a3f406/506150349e0.md): 为当前用户创建一条新的收货地址。若 is_default 为 true，则同时将该地址设为默认地址。
- 根目录 > V1 > 用户接口 > 收货地址 [获取地址详情](https://s.apifox.cn/beffd1da-1021-434c-8f13-8cbf50a3f406/506150350e0.md): 获取指定收货地址的详细信息，仅能查看属于当前用户的地址。
- 根目录 > V1 > 用户接口 > 收货地址 [更新收货地址](https://s.apifox.cn/beffd1da-1021-434c-8f13-8cbf50a3f406/506150351e0.md): 更新指定收货地址。仅能更新属于当前用户的地址。若 is_default 为 true，则同时将该地址设为默认地址。
- 根目录 > V1 > 用户接口 > 收货地址 [设为默认地址](https://s.apifox.cn/beffd1da-1021-434c-8f13-8cbf50a3f406/506150352e0.md): 将指定收货地址设为当前用户的默认地址，同时取消其它地址的默认状态。
- 根目录 > V1 > 用户接口 > 收货地址 [删除收货地址](https://s.apifox.cn/beffd1da-1021-434c-8f13-8cbf50a3f406/506150353e0.md): 删除指定收货地址（软删除）。仅能删除属于当前用户的地址。
- 根目录 > V1 > 用户接口 > 用户反馈 [提交反馈](https://s.apifox.cn/beffd1da-1021-434c-8f13-8cbf50a3f406/505293470e0.md): 用户提交反馈，支持游客匿名提交，已登录用户自动绑定 user_id。提交时自动采集 user_agent 和 ip_address。
- 根目录 > V1 > 用户接口 > 用户反馈 [我的反馈列表](https://s.apifox.cn/beffd1da-1021-434c-8f13-8cbf50a3f406/505293471e0.md): 获取当前登录用户的反馈列表（分页），需登录认证。
- 根目录 > V1 > 用户接口 > 实名认证 [我的认证信息](https://s.apifox.cn/beffd1da-1021-434c-8f13-8cbf50a3f406/514880370e0.md): 获取当前用户最新认证记录
- 根目录 > V1 > 用户接口 > 实名认证 [认证状态](https://s.apifox.cn/beffd1da-1021-434c-8f13-8cbf50a3f406/514880373e0.md): 简要认证状态（轻量接口）
- 根目录 > V1 > 用户接口 > 实名认证 [提交实名认证](https://s.apifox.cn/beffd1da-1021-434c-8f13-8cbf50a3f406/514881726e0.md): 提交或重新提交实名认证
- 根目录 > V1 > 用户接口 > 钱包 [我的钱包](https://s.apifox.cn/beffd1da-1021-434c-8f13-8cbf50a3f406/514880376e0.md): 当前登录用户钱包概览
- 根目录 > V1 > 用户接口 > 钱包 [充值订单列表](https://s.apifox.cn/beffd1da-1021-434c-8f13-8cbf50a3f406/514880377e0.md): 我的充值订单
- 根目录 > V1 > 用户接口 > 钱包 [充值订单详情](https://s.apifox.cn/beffd1da-1021-434c-8f13-8cbf50a3f406/514880460e0.md): 订单详情（可用于轮询支付状态）
- 根目录 > V1 > 用户接口 > 钱包 [钱包流水](https://s.apifox.cn/beffd1da-1021-434c-8f13-8cbf50a3f406/514880465e0.md): 我的钱包流水
- 根目录 > V1 > 用户接口 > 钱包 [提现申请列表](https://s.apifox.cn/beffd1da-1021-434c-8f13-8cbf50a3f406/514880466e0.md): 我的提现申请
- 根目录 > V1 > 用户接口 > 钱包 [提现详情](https://s.apifox.cn/beffd1da-1021-434c-8f13-8cbf50a3f406/514880468e0.md): 提现申请详情
- 根目录 > V1 > 用户接口 > 钱包 [创建充值订单](https://s.apifox.cn/beffd1da-1021-434c-8f13-8cbf50a3f406/514881728e0.md): 创建充值订单。当前仅支持 manual 后台确认渠道
- 根目录 > V1 > 用户接口 > 钱包 [提交提现申请](https://s.apifox.cn/beffd1da-1021-434c-8f13-8cbf50a3f406/514881759e0.md): 提交提现申请。仅支持选择已绑定的收款账户，不支持临时填写。提交后冻结对应金额，等待后台审核。
- 根目录 > V1 > 用户接口 > 钱包 [收款账户列表](https://s.apifox.cn/beffd1da-1021-434c-8f13-8cbf50a3f406/516728439e0.md): 获取当前用户的提现收款账户列表（分页），默认账户排在前面
- 根目录 > V1 > 用户接口 > 钱包 [添加收款账户](https://s.apifox.cn/beffd1da-1021-434c-8f13-8cbf50a3f406/516728445e0.md): 添加提现收款账户。首个账户自动设为默认。银行卡类型必填开户银行。
- 根目录 > V1 > 用户接口 > 钱包 [修改收款账户](https://s.apifox.cn/beffd1da-1021-434c-8f13-8cbf50a3f406/516728463e0.md): 修改收款账户信息（真实姓名、账号、状态等）
- 根目录 > V1 > 用户接口 > 钱包 [删除收款账户](https://s.apifox.cn/beffd1da-1021-434c-8f13-8cbf50a3f406/516728472e0.md): 软删除收款账户
- 根目录 > V1 > 用户接口 > 钱包 [设为默认收款账户](https://s.apifox.cn/beffd1da-1021-434c-8f13-8cbf50a3f406/516728476e0.md): 将指定收款账户设为默认（同类型下互斥，原默认自动取消）
- 根目录 > V1 > 用户接口 > 邀请接口 [获取我的邀请记录](https://s.apifox.cn/beffd1da-1021-434c-8f13-8cbf50a3f406/513246901e0.md): 分页查询当前登录用户邀请的用户列表，按记录 ID 倒序返回。
- 根目录 > V1 > 用户接口 > 邀请接口 [获取邀请统计](https://s.apifox.cn/beffd1da-1021-434c-8f13-8cbf50a3f406/513246906e0.md): 获取当前登录用户的邀请统计数据。
- 根目录 > V1 > 用户接口 > 任务接口 [任务中心列表](https://s.apifox.cn/beffd1da-1021-434c-8f13-8cbf50a3f406/513883013e0.md): 获取任务中心所有任务分组及任务列表，包含当前用户的任务进度。需要登录认证。
- 根目录 > V1 > 用户接口 > 任务接口 [领取任务奖励](https://s.apifox.cn/beffd1da-1021-434c-8f13-8cbf50a3f406/513883014e0.md): 手动领取已完成任务的奖励（仅领取方式为「手动领取」的任务需要调用此接口，自动发放的任务在完成后直接发放奖励）。需要登录认证。
- 根目录 > V1 > 用户接口 > 用户举报 [提交举报](https://s.apifox.cn/beffd1da-1021-434c-8f13-8cbf50a3f406/521114694e0.md): 提交举报：支持举报评论（comment）和用户（user）。同一人对同一目标在未结案前不可重复提交。需要登录态（auth:sanctum）。
- 根目录 > V1 > 用户接口 > 用户举报 [我的举报列表](https://s.apifox.cn/beffd1da-1021-434c-8f13-8cbf50a3f406/521114718e0.md): 当前登录用户提交过的所有举报记录（按时间倒序）。需要登录态（auth:sanctum）。
- 根目录 > V1 > 用户接口 [获取当前用户信息](https://s.apifox.cn/beffd1da-1021-434c-8f13-8cbf50a3f406/504499374e0.md): 获取当前登录用户的基本资料。
- 根目录 > V1 > 用户接口 [修改个人资料](https://s.apifox.cn/beffd1da-1021-434c-8f13-8cbf50a3f406/504499375e0.md): 修改昵称与扩展资料（生日、性别、地区、个人网站、简介、签名）。返回更新后的用户信息。
- 根目录 > V1 > 用户接口 [修改用户名](https://s.apifox.cn/beffd1da-1021-434c-8f13-8cbf50a3f406/504499406e0.md): 修改登录用户名。受 UsernameChangeRule 限制（是否允许修改及修改次数）。
- 根目录 > V1 > 用户接口 [修改邮箱](https://s.apifox.cn/beffd1da-1021-434c-8f13-8cbf50a3f406/504499413e0.md): 通过邮件验证码修改绑定邮箱。
- 根目录 > V1 > 用户接口 [修改手机号](https://s.apifox.cn/beffd1da-1021-434c-8f13-8cbf50a3f406/504499415e0.md): 通过短信验证码修改绑定手机号。
- 根目录 > V1 > 用户接口 [修改密码](https://s.apifox.cn/beffd1da-1021-434c-8f13-8cbf50a3f406/504500019e0.md): 使用旧密码校验后修改登录密码。
- 根目录 > V1 > 用户接口 [修改用户头像](https://s.apifox.cn/beffd1da-1021-434c-8f13-8cbf50a3f406/520874849e0.md): 修改当前登录用户的头像。
- 根目录 > V1 > 用户接口 [发送邮箱验证邮件](https://s.apifox.cn/beffd1da-1021-434c-8f13-8cbf50a3f406/504500039e0.md): 向当前用户邮箱重新发送验证链接邮件。
- 根目录 > V1 > 用户接口 [获取登录历史](https://s.apifox.cn/beffd1da-1021-434c-8f13-8cbf50a3f406/504500042e0.md): 分页获取当前用户的登录历史记录，按 ID 倒序。
- 根目录 > V1 > 用户接口 [获取积分记录](https://s.apifox.cn/beffd1da-1021-434c-8f13-8cbf50a3f406/504500047e0.md): 分页获取当前用户的积分变动记录，按 ID 倒序。
- 根目录 > V1 > 用户接口 [获取金币记录](https://s.apifox.cn/beffd1da-1021-434c-8f13-8cbf50a3f406/504500058e0.md): 分页获取当前用户的金币变动记录，按 ID 倒序。
- 根目录 > V1 > 用户接口 [注销并删除账户](https://s.apifox.cn/beffd1da-1021-434c-8f13-8cbf50a3f406/504500059e0.md): 注销当前账户（软删除）。删除时会级联清理该用户的社交绑定等关联数据。
- 根目录 > V1 > 用户接口 [获取第三方绑定](https://s.apifox.cn/beffd1da-1021-434c-8f13-8cbf50a3f406/520879188e0.md): 分页获取当前登录用户本人绑定的第三方社交账号列表。openid / unionid 已在资源层脱敏（保留前 4 位 + **** + 后 2 位），access_token / refresh_token 等敏感字段不会返回。可通过 `provider` 查询参数按渠道过滤（如 wechat_mp / apple / wechat_mini_program 等）。
- 根目录 > V1 > 互动接口 > 评论接口 [获取评论列表](https://s.apifox.cn/beffd1da-1021-434c-8f13-8cbf50a3f406/506645384e0.md): 
- 根目录 > V1 > 互动接口 > 评论接口 [发布评论](https://s.apifox.cn/beffd1da-1021-434c-8f13-8cbf50a3f406/506645682e0.md): 
- 根目录 > V1 > 互动接口 > 评论接口 [删除评论](https://s.apifox.cn/beffd1da-1021-434c-8f13-8cbf50a3f406/506645685e0.md): 
- 根目录 > V1 > 互动接口 > 点赞接口 [获取我的点赞列表](https://s.apifox.cn/beffd1da-1021-434c-8f13-8cbf50a3f406/506645181e0.md): 
- 根目录 > V1 > 互动接口 > 点赞接口 [添加点赞](https://s.apifox.cn/beffd1da-1021-434c-8f13-8cbf50a3f406/506645368e0.md): 
- 根目录 > V1 > 互动接口 > 点赞接口 [取消点赞](https://s.apifox.cn/beffd1da-1021-434c-8f13-8cbf50a3f406/506645380e0.md): 
- 根目录 > V1 > 互动接口 > 收藏接口 [获取我的收藏列表](https://s.apifox.cn/beffd1da-1021-434c-8f13-8cbf50a3f406/506645165e0.md): 
- 根目录 > V1 > 互动接口 > 收藏接口 [添加收藏](https://s.apifox.cn/beffd1da-1021-434c-8f13-8cbf50a3f406/506645173e0.md): 
- 根目录 > V1 > 互动接口 > 收藏接口 [取消收藏](https://s.apifox.cn/beffd1da-1021-434c-8f13-8cbf50a3f406/506645177e0.md): 
- 根目录 > V1 > 互动接口 > 访问记录 [记录一次访问](https://s.apifox.cn/beffd1da-1021-434c-8f13-8cbf50a3f406/521022106e0.md): 
- 根目录 > V1 > 互动接口 > 访问记录 [我的访问记录](https://s.apifox.cn/beffd1da-1021-434c-8f13-8cbf50a3f406/521022338e0.md): 
- 根目录 > V1 > 互动接口 > 访问记录 [我的访问记录](https://s.apifox.cn/beffd1da-1021-434c-8f13-8cbf50a3f406/521022351e0.md): 
- 根目录 > V1 > 互动接口 > 关注接口 [获取我的关注列表](https://s.apifox.cn/beffd1da-1021-434c-8f13-8cbf50a3f406/523935020e0.md): 
- 根目录 > V1 > 互动接口 > 关注接口 [添加关注](https://s.apifox.cn/beffd1da-1021-434c-8f13-8cbf50a3f406/523935024e0.md): 
- 根目录 > V1 > 互动接口 > 关注接口 [取消关注](https://s.apifox.cn/beffd1da-1021-434c-8f13-8cbf50a3f406/523935029e0.md): 
- 根目录 > V1 > 轮播图接口 [获取指定广告位的 Banner](https://s.apifox.cn/beffd1da-1021-434c-8f13-8cbf50a3f406/507624499e0.md): 获取指定广告位下当前生效的 Banner 列表（公开，无需认证）
- 根目录 > V1 > 公告接口 [公告列表](https://s.apifox.cn/beffd1da-1021-434c-8f13-8cbf50a3f406/512627232e0.md): 
- 根目录 > V1 > 公告接口 [公告详情](https://s.apifox.cn/beffd1da-1021-434c-8f13-8cbf50a3f406/512627234e0.md): 
- 根目录 > 微信公众号 [网络通信检测](https://s.apifox.cn/beffd1da-1021-434c-8f13-8cbf50a3f406/505798225e0.md): 调用微信公众号网络通信检测接口，用于验证服务器与微信服务器之间的通信链路是否正常。
- 根目录 > 微信公众号 [跳转微信授权](https://s.apifox.cn/beffd1da-1021-434c-8f13-8cbf50a3f406/505798227e0.md): 跳转到微信 OAuth 授权页面（snsapi_userinfo 模式），授权完成后回调到 auth-callback 接口。
- 根目录 > 微信公众号 [授权回调](https://s.apifox.cn/beffd1da-1021-434c-8f13-8cbf50a3f406/505798240e0.md): 微信网页授权回调接口，通过授权 code 换取用户信息（snsapi_userinfo）。
- 根目录 > 微信公众号 [授权重定向（带 redirect_uri）](https://s.apifox.cn/beffd1da-1021-434c-8f13-8cbf50a3f406/505798243e0.md): 带自定义 redirect_uri 的微信授权中转接口。首次请求无 code 时跳转到微信授权页，授权回跳后再把 wx_code 拼到原 redirect_uri 上返回。
- 根目录 > 微信公众号 [授权代理（直接拼 URL）](https://s.apifox.cn/beffd1da-1021-434c-8f13-8cbf50a3f406/505798246e0.md): 纯代理式微信授权接口，直接拼接 open.weixin.qq.com 授权 URL，不经过 EasyWeChat SDK 的 OAuth 服务。
- 根目录 > 微信公众号 [通过 Code 获取用户信息](https://s.apifox.cn/beffd1da-1021-434c-8f13-8cbf50a3f406/505798249e0.md): 通过微信授权 code 获取用户基本信息。
- 根目录 > 微信公众号 [微信服务端消息回调](https://s.apifox.cn/beffd1da-1021-434c-8f13-8cbf50a3f406/505798254e0.md): 微信公众号服务器配置的消息与事件接收地址。支持验证（GET）和消息推送（POST），内部通过事件（WechatSubscribed / WechatUnsubscribed / WechatScan）分发业务逻辑。