本文主要适用于第三方开发者,更新日志会着重偏向API的更新,以便第三方开发者能够方便、快速的更新客户端。
站点图床已切换为新的 RhyPic(韵图) 图床,旧上传接口 POST /upload 将在不久后彻底停用。请第三方客户端尽快阅读最新对接文档,按「获取上传票据 → 直传韵图」两步流程完成适配:
新流程的响应结构(data.errFiles / data.succMap)与旧接口兼容,原有解析逻辑可直接沿用,主要变更为鉴权方式(一次性票据请求头)、上传地址(韵图图床)与文件字段名(file)。
新增 POST /api/medal/admin/holds,支持查询单个用户或最多 100 个用户是否持有指定勋章。接口返回当前持有状态、过期状态、到期时间和勋章数据。
新增 POST /api/medal/admin/grant-batch,支持向单个用户或最多 100 个用户发放指定勋章。批量写入使用同一事务,任一用户校验或写入失败时整批失败;已有勋章会更新到期时间和勋章数据。
原有单用户接口保持兼容。
活动页的固定鱼游列表调整为“摸鱼鱼游”内容库,支持展示已审核鱼游、点赞、点踩和评论。
用户可投稿网站,投稿内容由管理员人工审核后公开。投稿作者可以提交资料修改申请,审核通过后更新公开内容。
新增鱼游管理页,管理员可手动添加、审核、停用、编辑、导入和导出鱼游数据。旧活动页的固定鱼游清单已整理为导入文件。
第三方接口已补充到 API 文档,包括投稿、修改申请、投票、评论和管理员管理接口。
修正鱼游接口的 API key 认证示例;写入接口增加 CSRF 校验和用户频率限制。
普通发帖页改为通过“这是好帖”复选框申请优质奖励,不再在发布时弹出奖励选择窗口。获得奖励的帖子会显示“好帖”标识。
管理员、OP 和超级会员新增免审发帖与免审保存入口。该入口会跳过敏感词过滤和内容审核,服务端会按用户分组校验权限,未授权请求会被拒绝。
发帖和更新帖子接口新增可选参数 articleBypassCensor,接口文档已同步更新。
PC 与移动端同步调整普通发帖和长文发布页的操作区布局。
专栏书城改为“最新专栏”和“热门专栏”分区展示,并调整专栏卡片样式。
职业设置页调整分区间距与预设选项样式。
- 新增“复读机转录站”:首页展示段子、星期四、鱼科普内容,支持随机切换、复制、点赞、登录后上传。
- 新增专栏封面能力:专栏支持自定义封面,长篇发布页可带封面,作者可在 /column/manage 管理封面
评论增加新的接口,按层级模式展示评论,原接口仍兼容保留,API文档已更新
同样已更新到API文档,注意普通帖子和长文章虽然API相同,但是参数(type)不同,开发时请仔细阅读。
帖子历史版本 diff 功能重构,历史记录列表与具体版本正文改为按需读取,避免长帖多次更新后一次性返回全部历史正文。
新增两个帖子历史版本接口:
GET /article/{id}/revisions/listGET /article/{id}/revisions/{revisionId}
原 GET /article/{id}/revisions 接口已移除,第三方客户端需改用新的列表接口和详情接口。
帖子历史版本弹窗同步优化,支持选择任意两个历史版本进行标题和正文对比,也可以只显示差异部分,复制内容时不再包含 + / - 标记。
此功能已适配 API,可参阅 https://fishpi.cn/article/1636516552191 的 【模块:帖子历史版本】章节
补充评论历史版本 API 文档:
GET /comment/{id}/revisions
该接口用于获取指定评论的历史版本列表,返回评论历史正文。评论历史接口为既有接口,本次未拆分为列表接口和详情接口。
帖子和表情新增emoji贴纸选项,该贴纸不消耗积分,可反复修改要贴的emoji贴纸,emoji为预置不可自定义。
此功能已适配API,可参阅 https://fishpi.cn/article/1636516552191 的 【模块:贴emoji】章节


