万能墙 API 接口文档
> 自动生成(来源:backend/api_meta.php 的接口说明表 + api.php 源码扫描),请勿手改。
> 接口总数 160(GET 58 / POST 102,需登录 74,后台接口 21,插件接口 0),已写说明 160/160。
调用约定
- 入口:
/api?action=<接口名>;成功与失败都返回 JSON,统一带success/code/api_version/data。 - 写接口必须 POST,并携带
csrf_token(先调get_csrf取,或放请求头X-CSRF-Token)。 - 需要登录的接口未登录时返回
AUTH_REQUIRED;后台接口返回FORBIDDEN,账号被停用返回ACCOUNT_DISABLED。 - 模块被关闭时相关接口返回
MODULE_CLOSED;管理员校区范围外返回OUT_OF_SCOPE。 - 完整机器可读清单:
api?action=api_index;钩子清单:api?action=api_hooks。
聊天室(12)
| 接口 | 方法 | 鉴权 | 说明 |
| --- | --- | --- | --- |
| chat_create | POST | 登录 | 创建聊天室(房主自动成为管理员) |
| chat_delete_message | POST | 登录 | 撤回/删除聊天消息(房主或管理员) |
| chat_history | GET | 公开 | 聊天记录(按房间与时间游标拉取历史消息) |
| chat_join | POST | 登录 | 加入聊天室(写入成员表,房主自动成为管理员) |
| chat_leave | POST | 登录 | 退出聊天室(房主退出会移交或关闭房间) |
| chat_poll | GET | 公开 | 聊天增量轮询(拉取新消息、成员、投票等) |
| chat_room_context | POST | 登录 | 聊天室首页所需上下文(房间信息 + 成员 + 我的身份) |
| chat_rooms | GET | 公开 | 聊天室列表(含人数、消息数与我的身份) |
| chat_send | POST | 登录 | 发言(关键词过滤 + 限流) |
| chat_set_admin | POST | 登录 | 设置/取消聊天室管理员(房主权限) |
| chat_vote | POST | 登录 | 聊天室内投票(如踢人表决) |
| chat_vote_status | GET | 公开 | 聊天室投票当前状态 |
聊天室 · 参数
chat_create
name— string 房间名description— string 房间简介
chat_delete_message
room_id— int 房间 IDmessage_id— int 消息 ID
chat_join
room_id— int 房间 ID
chat_leave
room_id— int 房间 ID
chat_poll
room_id— int 房间 IDsince_id— int 上次拿到的最大消息 ID
chat_room_context
id— int 房间 ID
chat_send
room_id— int 房间 IDcontent— string 消息内容(先过关键词库,命中则拦截/打码)
chat_set_admin
room_id— int 房间 IDtarget_id— int 目标用户 IDmake_admin— bool 1 设为管理员 / 0 取消管理员
chat_vote
room_id— int 房间 IDcandidate_id— int 被投票的目标
chat_vote_status
room_id— int 房间 ID
硬币系统(3)
| 接口 | 方法 | 鉴权 | 说明 |
| --- | --- | --- | --- |
| coin | POST | 登录 | 给帖子投币(消耗自己的硬币,受限流与余额校验) |
| coin_balance | GET | 登录 | 当前用户硬币余额与今日已得 |
| coin_transactions | GET | 登录 | 硬币收支流水(最近若干条) |
硬币系统 · 参数
coin
post_id— int 帖子 IDcount— int 投币数量
校草校花(9)
| 接口 | 方法 | 鉴权 | 说明 |
| --- | --- | --- | --- |
| contest_candidate | GET | 公开 | 校草校花投稿详情(本人或审核人可见) |
| contest_comment | POST | 公开 | 候选人留言(先打码再送审) |
| contest_entry | POST | 登录 | 校草校花投稿 |
| contest_vote | POST | 登录 | 校草校花投票 |
| get_contest | GET | 公开 | 校草校花评比数据 |
| get_contest_candidate | GET | 公开 | 校草校花候选人详情 |
| get_contest_champions | GET | 公开 | 历届校草校花冠军榜 |
| get_contest_comments | GET | 公开 | 候选人留言列表 |
| get_contest_review | GET | 登录 | 待审核的校草校花投稿列表(审核人用) |
校草校花 · 参数
contest_comment
candidate_id— int 候选人 IDcontent— string 留言内容publish_as— enum 发布身份:account 用账号名 / anonymous 匿名nickname— string 兼容旧客户端fingerprint— string 设备指纹admin_username— string 可选,风纪委员认证admin_password— string 可选,认证密码
contest_entry
category— enum 组别:hunk 校草 / beauty 校花dimension— enum 维度:real 三次元 / fiction 二次元name— string 姓名或角色名bio— string 简介photo— string 照片文件名grade— string 年级class_name— string 班级submitter_name— string 投稿人真实姓名submitter_grade— string 投稿人年级submitter_class— string 投稿人班级agree_terms— bool 1 表示已签署免责条款与承诺书terms_start— int 开始阅读条款的时间戳fingerprint— string 设备指纹
contest_vote
id— int 候选人 ID(每人每天每组限票)
get_contest_review
format— json 时返回结构化数据
基础(86)
| 接口 | 方法 | 鉴权 | 说明 |
| --- | --- | --- | --- |
| account_bindings | GET | 登录 | 查询当前账号的第三方绑定情况 |
| admin_announcement_save | POST | 后台 | 新增/编辑公告(支持 Markdown 与配图) |
| admin_announcements_list | POST | 后台 | 后台公告列表(含草稿与发布时间) |
| admin_comment_delete | POST | 后台 | 后台删除评论 |
| admin_comments_list | POST | 后台 | 后台评论列表(按帖子筛选,分页) |
| admin_config_get | POST | 后台 | 后台读取站点配置(仅后台身份,返回可配置项) |
| admin_config_save | POST | 后台 | 后台配置保存 |
| admin_event_review | POST | 后台 | 趣事审核(列表/通过/驳回/删除) |
| admin_food_review | POST | 后台 | 必吃榜审核(列表/通过/驳回/删除/编辑) |
| admin_hero_review | POST | 后台 | 豪王赛审核(列表/通过/驳回/删除) |
| admin_login | POST | 公开 | 后台登录(密码或 U 盘密钥,带限流与登录日志) |
| admin_logout | POST | 后台 | 后台退出登录(清除后台会话) |
| admin_post_action | POST | 后台 | 后台帖子操作(软删/恢复/永久删除/置顶/关评论/改内容) |
| admin_posts_list | POST | 后台 | 后台帖子列表(分页 + 关键词 + 状态筛选,按管理员的校区范围过滤) |
| admin_report_handle | POST | 后台 | 处理举报(忽略 / 删帖 / 删帖并拉黑设备) |
| admin_reports_list | POST | 后台 | 后台举报列表(按状态筛选) |
| admin_user_action | POST | 后台 | 后台用户操作(改名/改头衔/删除/删除并连带帖子进回收站) |
| admin_users_list | POST | 后台 | 后台用户列表(分页 + 关键词,按管理员的校区范围过滤) |
| agree_terms | POST | 登录 | 记录同意用户协议(阅读时长由服务端校验) |
| ai_draft | POST | 登录 | AI 草稿生成(润色通道) |
| ai_faq | POST | 登录 | AI 规则问答(润色通道) |
| ai_polish | POST | 登录 | 文案润色(润色通道) |
| ai_polish_test | POST | 后台 | AI 润色联调测试(后台配置页用,消耗一次 AI 调用) |
| aidiy_test | POST | 公开 | 自定义 AI 通道自检 |
| api_hooks | GET | 登录 | 可用钩子(action/filter)清单与说明 |
| api_index | GET | 登录 | 接口清单(含方法/鉴权/参数/来源),供插件与文档使用 |
| apply_upload_music_dup | POST | 后台 | 应用「重名音乐」的处理决策(覆盖/保留/跳过) |
| bind_email_request | POST | 登录 | 绑定/更换邮箱:校验密码后发验证邮件 |
| captcha | GET | 公开 | 生成图形验证码(发帖/评论前的人机校验) |
| change_password | POST | 公开 | 修改/设置密码(QQ 微信注册的账号无需原密码,只需新密码两次) |
| check_update | GET | 公开 | 客户端版本检查 |
| cloud_ai_test | POST | 公开 | 云端审核通道自检 |
| contest_review | POST | 登录 | 校草校花审核(风纪委员/管理员通过或驳回) |
| delete_account | POST | 登录 | 注销账号(校验密码;连带清理关注/硬币/统计/头像,帖子保留) |
| delete_avatar | POST | 登录 | 删除头像(引用计数归零后物理删除文件) |
| delete_music_cover | POST | 后台 | 删除音乐封面(无人引用时物理删除) |
| forgot_password | POST | 公开 | 忘记密码(发重置邮件) |
| get_about | GET | 公开 | 关于页数据(统计/运行时间/鸣谢) |
| get_announcement | GET | 公开 | 当前生效的站点公告 |
| get_cloud_announcements | GET | 公开 | 拉取云端公告(后台/前台提示条) |
| get_cloud_sensitive_words | GET | 公开 | 拉取云端预置敏感词(聊天关键词库) |
| get_csrf | GET | 公开 | 取 CSRF token(写操作必须带 X-CSRF-Token) |
| get_feedbacks | GET | 公开 | 反馈列表(管理员看全部,普通用户看自己的) |
| get_latest_version | GET | 公开 | 查询最新版本与更新说明 |
| get_memorial | GET | 公开 | 纪念日/缅怀日内容 |
| get_post | GET | 公开 | 帖子详情(含作者展示信息、媒体、点赞与评论) |
| get_profile | GET | 公开 | 个人主页数据 |
| get_schools | GET | 公开 | 学校列表(按级别/区域组织,投稿与个人中心选择用) |
| get_site_bg | GET | 公开 | 站点背景图配置(主题用) |
| get_topics | GET | 公开 | 话题标签列表 |
| heartbeat | POST | 公开 | 页面心跳(更新在线状态与最后活跃时间) |
| like_music | POST | 公开 | 点赞音乐(切换式) |
| listing_hide | POST | 登录 | 卖家隐藏/显示自己的商品 |
| login | POST | 公开 | 账号密码登录 |
| logout | POST | 登录 | 退出登录(销毁会话;需登录) |
| me | GET | 登录 | 当前登录用户信息与个人中心开关 |
| my_posts | GET | 登录 | 我的帖子 / 回收站 / 被风纪处理的帖子 |
| oauth_consume_ticket | GET | 公开 | 消费一次登录票据(把票据换成会话,票据一次性) |
| oauth_pair_new | POST | 公开 | 生成「扫码绑定」配对码(新设备/新浏览器确认用) |
| oauth_pair_poll | GET | 公开 | 轮询配对结果(绑定是否已被确认) |
| online_count | GET | 公开 | 当前在线人数(心跳统计,带短缓存) |
| page_context | GET | 登录 | 页面壳渲染所需的登录态与站点配置 |
| record_music_play | POST | 公开 | 记录一次音乐播放(播放量统计) |
| register | POST | 公开 | 邮箱注册(需同意条款 + 阅读 20 秒) |
| report_post | POST | 公开 | 举报帖子(写入待处理举报列表) |
| resend_verification | POST | 公开 | 重发邮箱验证邮件(可带账号标识与密码确认) |
| reset_password | POST | 公开 | 通过邮件链接重置密码 |
| submit_feedback | POST | 公开 | 提交用户反馈(可留联系方式) |
| toggle_post_comments | POST | 登录 | 楼主关闭/开启自己帖子的评论区 |
| unbind_email | POST | 登录 | 解绑邮箱(需密码确认) |
| unbind_oauth | POST | 登录 | 解绑第三方账号(需密码确认) |
| update_email_notify | POST | 登录 | 新帖邮件推送开关(默认关闭) |
| update_email_react_notify | POST | 登录 | 点赞/评论邮件通知开关(默认关闭) |
| update_profile | POST | 登录 | 更新资料(昵称/学校等) |
| update_school | POST | 登录 | 保存学校信息(级别/区域/学校名) |
| update_show_android_btn | POST | 登录 | 首页「安卓客户端」按钮开关(下载功能已下线,仅保留接口兼容) |
| update_show_music_player | POST | 登录 | 个人中心音乐播放器显示开关 |
| update_username | POST | 登录 | 修改用户名(有频率与敏感词校验) |
| upload | POST | 登录 | 通用媒体上传(图片/视频,返回文件地址;发帖前上传需在规定时间内使用,否则会被自动清理) |
| upload_avatar | POST | 登录 | 上传头像(自动压缩) |
| upload_music | POST | 后台 | 上传音乐文件到曲库(管理员/音乐管理员) |
| upload_music_cover | POST | 后台 | 上传/替换音乐封面 |
| verify_admin | POST | 公开 | 校验后台账号密码(用于敏感操作二次确认) |
| verify_captcha | POST | 公开 | 校验图形验证码 |
| verify_email | GET | 公开 | 邮箱验证链接落地(校验 token 并标记已验证) |
| year_review_stats | POST | 登录 | 年度报告统计数据 |
基础 · 参数
admin_announcement_save
id— int 公告 ID(0 表示新增)content— string 公告正文(支持 Markdown)image— string 配图文件名mode— enum 操作:save 保存 / toggle 切换显示 / delete 删除
admin_comment_delete
id— int 评论 ID
admin_comments_list
post_id— int 指定帖子的评论(0 表示不筛)offset— int 起始位置(分页)limit— int 每页条数(1~50)
admin_config_save
site_name— string 站点名称theme— string 主题色theme_scheme— string 配色方案custom_colors— json 自定义配色theme_auto_switch— bool 1 开启主题自动切换pure_mode— bool 1 简洁模式login_enabled— bool 1 开放登录login_required— bool 1 强制登录email_verify_enabled— bool 1 开启邮箱验证maintenance_enabled— bool 1 开启维护模式maintenance_start— string 维护开始时间 HH:MMmaintenance_end— string 维护结束时间 HH:MMbug_page_enabled— bool 1 开启报错页bug_page_start— string 报错页开始时间bug_page_end— string 报错页结束时间bug_page_reason— string 报错页说明文案sensitive_words— string 自定义敏感词(换行分隔)
admin_event_review
op— enum 操作:list 列表 / toggle 通过-驳回 / delete 删除id— int 趣事 ID
admin_food_review
op— enum 操作:list 列表 / toggle 通过-驳回 / delete 删除 / edit 编辑id— int 条目 IDname— string 店名或菜名category— string 分类address— string 地址description— string 推荐理由
admin_hero_review
op— enum 操作:list 列表 / toggle 通过-驳回 / delete 删除id— int 参赛者 ID
admin_login
username— string 管理员账号password— string 登录密码usb_key— string 可选,U 盘密钥文件内容login_mode— enum 登录方式:password 密码 / usb U 盘密钥
admin_post_action
id— int 帖子 IDop— enum 操作:delete 软删 / restore 恢复 / purge 永久删除 / pin 置顶 / unpin 取消置顶 / toggle_comments 切换评论区 / edit 改内容content— string op=edit 时的新正文
admin_posts_list
offset— int 起始位置(分页)limit— int 每页条数(1~50)filter— enum 筛选:all 全部 / active 正常 / deleted 回收站 / pending 待审q— string 关键词(正文或昵称)
admin_report_handle
id— int 举报 IDmode— enum 处理方式:dismiss 忽略 / delete 删除帖子 / delete_ban 删除并拉黑设备
admin_reports_list
status— enum 状态:0 待处理 / 1 已忽略 / 2 已删除 / 3 已删除并拉黑 / all 全部offset— int 起始位置(分页)limit— int 每页条数(1~50)
admin_user_action
id— int 用户 IDop— enum 操作:rename 改名 / title 改头衔 / delete 删号 / delete_with_posts 删号并连带帖子进回收站username— string op=rename 时的新用户名title— string op=title 时的新头衔
admin_users_list
q— string 关键词(用户名或头衔)offset— int 起始位置(分页)limit— int 每页条数(1~50)
agree_terms
terms_read_start— int 开始阅读的时间戳
ai_draft
topic— string 话题column— string 栏目
ai_faq
q— string 用户提问(返回帮助中心答案)
ai_polish
content— string 待润色文本(返回润色结果,不落库)
ai_polish_test
content— string 待润色文本
aidiy_test
content— string 测试文本(验证 AI 自定义接口)
apply_upload_music_dup
file— string 文件名title— string 歌曲标题cover— string 封面文件名dup_action— enum 处理:overwrite 覆盖 / keep 都保留 / skip 跳过
bind_email_request
email— string 新邮箱password— string 当前密码
change_password
password— string 新密码password2— string 再次输入old_password— string 老密码(已设置过密码的账号必填)
cloud_ai_test
content— string 测试文本(验证云端 AI 通道连通性)
contest_review
id— int 投稿 IDapprove— 1|0 通过或驳回reason— string 驳回理由
delete_account
password— string 当前密码(注销前确认)
delete_music_cover
file— string 文件名
forgot_password
identifier— string 用户名或邮箱
get_feedbacks
filter— enum 筛选:all 全部 / pending 待处理 / done 已处理format— string 传 json 返回结构化数据
heartbeat
uid— int 可选,未登录时用匿名标识
like_music
file— string 文件名
listing_hide
id— int 商品 IDhidden— bool 1 隐藏 / 0 显示
login
username— string 用户名或邮箱password— string 密码remember— bool 1 记住我(30 天免登录)
oauth_consume_ticket
ticket— string 登录票据
oauth_pair_poll
pair— string 配对码
record_music_play
file— string 文件名
register
email— string 邮箱username— string 可选,用户名(留空自动生成)password— string 密码agree_terms— bool 1 表示已同意用户协议terms_start— int 开始阅读协议的时间戳
report_post
post_id— int 帖子 IDreason— string 举报类型detail— string 补充说明fingerprint— string 设备指纹
resend_verification
identifier— string 用户名或邮箱password— string 可选,密码确认old_password— string 可选password2— string 可选username— string 可选token— string 可选,验证令牌
reset_password
token— string 邮件里的重置令牌password— string 新密码
submit_feedback
content— string 反馈内容contact— string 联系方式fingerprint— string 设备指纹
toggle_post_comments
post_id— int 帖子 ID
unbind_email
password— string 当前密码
unbind_oauth
provider— enum 平台:qq / wxpassword— string 当前密码(确认身份)
update_email_notify
email_notify— 0|1 新帖发布邮件推送开关
update_email_react_notify
email_react_notify— 0|1 点赞/评论邮件提醒开关
update_profile
bio— string 个性签名contact— string 联系方式phone— string 手机号grade— string 年级class_name— string 班级
update_school
school_level— enum 学段:high 高中 / middle 初中school_area— string 区域school_name— string 学校名称
update_show_android_btn
show_android_btn— bool 1 显示 / 0 隐藏(下载功能已下线,仅保留兼容)
update_show_music_player
show_music_player— bool 1 显示音乐播放器 / 0 隐藏
update_username
username— string 新用户名
upload
file— file 媒体文件(图片/视频,字段名 file)
upload_avatar
file— file 头像图片(表单字段 file,服务端转 webp 并清理旧头像)
upload_music
dup_action— overwrite|keep|skip 重名处理
upload_music_cover
file— file 图片文件
verify_admin
username— string 管理员账号password— string 密码
verify_captcha
code— string 用户输入的验证码
verify_email
token— string 邮件里的验证令牌
year_review_stats
with_user— int 可选,是否带上当前用户维度
小法庭(7)
| 接口 | 方法 | 鉴权 | 说明 |
| --- | --- | --- | --- |
| court_file | POST | 登录 | 提起小法庭诉讼(原告填写被告、原因与诉求,可附证据) |
| court_respond | POST | 登录 | 小法庭应诉(被告提交答辩与证据) |
| court_vote | POST | 登录 | 小法庭投票(原告/被告方,按投票人资格校验) |
| court_withdraw | POST | 登录 | 原告撤诉(案件转为已撤诉,不再计票) |
| get_court_case | GET | 公开 | 小法庭案件详情(含证据与票数) |
| get_court_cases | GET | 公开 | 小法庭案件列表 |
| get_court_users | GET | 公开 | 小法庭可投票用户列表(按学校范围) |
小法庭 · 参数
court_file
defendant_id— int 被告用户 IDreason— string 起诉原因claim— string 诉求evidence_list— json 证据文件数组
court_respond
case_id— int 案件 IDstatement— string 答辩说明claim— string 反诉诉求evidence_list— json 证据文件数组
court_vote
case_id— int 案件 IDside— plaintiff|defendant 支持哪一方
court_withdraw
case_id— int 案件 ID
get_court_case
id— int 案件 IDformat— json 时返回结构化数据
风纪委员会(6)
| 接口 | 方法 | 鉴权 | 说明 |
| --- | --- | --- | --- |
| discipline_apply | POST | 登录 | 申请加入风纪委员会(填写真实姓名/年级/班级/学校) |
| discipline_post | POST | 登录 | 风纪处理帖子:hide/show/delete(需理由、留痕、限额) |
| discipline_remove | POST | 登录 | 移除某用户的风纪委员身份(风纪主席/超管) |
| discipline_review | POST | 登录 | 审批风纪委员会入会申请(风纪主席/超管) |
| get_discipline | GET | 登录 | 风纪委员会主页数据(成员/申请/日志) |
| get_discipline_logs | GET | 登录 | 风纪操作留痕 |
风纪委员会 · 参数
discipline_apply
real_name— string 真实姓名grade— string 年级class— string 班级school— string 学校
discipline_post
op— delete|restore|hide 等风纪操作post_id— int 帖子 IDreason— string 处理理由(留痕)
discipline_remove
user_id— int 用户 ID
discipline_review
app_id— int 申请 IDapprove— 1|0 通过或驳回
get_discipline
format— json 时返回结构化数据
趣事(4)
| 接口 | 方法 | 鉴权 | 说明 |
| --- | --- | --- | --- |
| create_event | POST | 登录 | 投稿趣事(官方/小道消息 + 时间地点,需审核) |
| event_comment | POST | 登录 | 趣事评论(支持匿名/账号身份,过词库与限流) |
| get_event | GET | 公开 | 趣事详情(含评论) |
| get_events | GET | 公开 | 校园趣事列表 |
趣事 · 参数
create_event
name— string 标题description— string 内容location— string 地点event_date— string 时间msg_type— enum 消息类型:official 官方 / rumor 小道publish_as— enum 发布身份:account 用账号名 / anonymous 匿名nickname— string 兼容旧客户端fingerprint— string 设备指纹
event_comment
event_id— int 趣事 IDcontent— string 评论内容publish_as— enum 发布身份:account 用账号名 / anonymous 匿名nickname— string 兼容旧客户端fingerprint— string 设备指纹
get_event
id— int 趣事 IDformat— json 时返回结构化数据
关注关系(4)
| 接口 | 方法 | 鉴权 | 说明 |
| --- | --- | --- | --- |
| follow | POST | 登录 | 关注/取关某用户(切换式) |
| follow_list | GET | 公开 | 关注/粉丝列表 |
| follow_stats | GET | 公开 | 某用户的关注数/粉丝数与是否已关注 |
| update_follower_privacy | POST | 登录 | 设置粉丝数是否公开 |
关注关系 · 参数
follow
target_id— int 目标用户 ID
follow_list
target_id— int 目标用户 IDmode— enum 列表类型:following 我关注的 / followers 关注我的
follow_stats
target_id— int 目标用户 ID
update_follower_privacy
show— bool 1 公开粉丝数 / 0 隐藏
foods(5)
| 接口 | 方法 | 鉴权 | 说明 |
| --- | --- | --- | --- |
| create_food | POST | 登录 | 投稿必吃榜(店铺/菜品 + 图片,需审核) |
| food_comment | POST | 登录 | 必吃榜评论(可带评分) |
| food_like | POST | 公开 | 给必吃榜条目点赞(去重) |
| get_food | GET | 公开 | 必吃榜条目详情(含评论) |
| get_foods | GET | 公开 | 必吃榜列表(可按分类/关键词/学校筛选) |
foods · 参数
create_food
name— string 店名或菜名category— string 分类address— string 地址description— string 推荐理由image— string 图片文件名publish_as— enum 发布身份:account 用账号名 / anonymous 匿名nickname— string 兼容旧客户端fingerprint— string 设备指纹
food_comment
food_id— int 条目 IDcontent— string 评论内容rating— int 1~5 评分publish_as— enum 发布身份:account 用账号名 / anonymous 匿名nickname— string 兼容旧客户端fingerprint— string 设备指纹
food_like
id— int 条目 ID
get_food
id— int 条目 IDformat— json 时返回结构化数据
豪王赛(8)
| 接口 | 方法 | 鉴权 | 说明 |
| --- | --- | --- | --- |
| get_hero | GET | 公开 | 豪王赛参赛者详情(含票数、留言与应援数) |
| get_heroes | GET | 公开 | 豪王挑战赛列表 |
| hero_comment | POST | 登录 | 豪王赛留言(对参赛者的公开留言) |
| hero_entry | POST | 登录 | 豪王赛报名(姓名/年级/班级/事迹 + 照片) |
| hero_like | POST | 登录 | 给参赛者点赞(去重) |
| hero_poll | GET | 公开 | 豪王页轮询(增量拉取新留言/票数) |
| hero_ranking | GET | 公开 | 豪王排行榜(按票数) |
| hero_support | POST | 登录 | 支持/应援参赛者 |
豪王赛 · 参数
get_hero
id— int 参赛者 IDformat— json 时返回结构化数据
hero_comment
hero_id— int 参赛者 IDcontent— string 留言内容nickname— string 昵称fingerprint— string 设备指纹
hero_entry
name— string 姓名grade— string 年级class_name— string 班级deeds— string 事迹photo— string 照片文件名fingerprint— string 设备指纹
hero_like
hero_id— int 参赛者 ID
hero_poll
hero_id— int 参赛者 IDlast_id— int 上次拿到的最大 ID
hero_support
hero_id— int 参赛者 ID
校园集市(5)
| 接口 | 方法 | 鉴权 | 说明 |
| --- | --- | --- | --- |
| listing_create | POST | 登录 | 发布集市信息 |
| listing_delete | POST | 登录 | 卖家删除自己的商品(软删除进回收站) |
| listing_detail | GET | 公开 | 集市信息详情(浏览计数、卖家信息) |
| listing_status | POST | 登录 | 卖家标记商品状态(在售/已售/下架) |
| listings_list | GET | 公开 | 校园集市列表(按类型/学校/关键词筛选,支持分页) |
校园集市 · 参数
listing_create
title— string 标题type— sell|buy|team|lost 信息类型price— string 价格description— string 描述images— json 图片数组contact— string 联系方式
listing_delete
id— int 商品 ID
listing_detail
id— int 商品 IDformat— json 时返回结构化数据
listing_status
id— int 商品 IDstatus— on|sold|closed 目标状态
moderation(1)
| 接口 | 方法 | 鉴权 | 说明 |
| --- | --- | --- | --- |
| moderation_words | GET | 登录 | 本地违禁词表(前端即时预检用) |
music(3)
| 接口 | 方法 | 鉴权 | 说明 |
| --- | --- | --- | --- |
| get_music_library | GET | 公开 | 站点音乐库(含封面与播放次数) |
| get_music_list | GET | 公开 | 音乐列表(当前曲库与我的歌单) |
| save_music_list | POST | 登录 | 保存我的歌单顺序 |
music · 参数
save_music_list
list— json 文件名数组
帖子与互动(7)
| 接口 | 方法 | 鉴权 | 说明 |
| --- | --- | --- | --- |
| comment | POST | 登录 | 发表评论(支持匿名/账号身份,本地词库 + AI 审核 + 限流) |
| create_post | POST | 登录 | 发帖(本地违禁词 + AI 审核 + 限流) |
| delete_post | POST | 登录 | 删除自己的帖子(进回收站) |
| like | POST | 登录 | 点赞(防重 + 限流) |
| load_more_posts | GET | 公开 | 信息流分页加载(HTML 或 JSON,支持关键词与校区筛选) |
| purge_post | POST | 登录 | 永久删除自己删除的帖子(含媒体) |
| restore_post | POST | 登录 | 恢复自己删除的帖子(24h 内) |
帖子与互动 · 参数
comment
post_id— int 帖子 IDcontent— string 评论内容publish_as— enum 发布身份:account 用账号名 / anonymous 匿名nickname— string 兼容旧客户端fingerprint— string 设备指纹admin_username— string 可选,管理员认证身份admin_password— string 可选,管理员认证密码
create_post
content— string 正文publish_as— enum 发布身份:account 用账号名 / anonymous 匿名topic— string 可选,话题标签media— json 媒体数组(文件地址)
delete_post
post_id— int 帖子 ID(仅本人,进回收站)
like
post_id— int 帖子 ID(服务端按用户/设备去重)
load_more_posts
page— int 页码school— string 可选
purge_post
post_id— int 帖子 ID(永久删除,含媒体文件)
restore_post
post_id— int 帖子 ID(24 小时内可恢复)