概述 该文档主要面向社区客户端开发者,如果你想开发一个移动端 APP 的话请仔细阅读该文档。如果你喜欢写博客,想要将博客和社区进行联动的话请参考[链接] 。 目前以下列出的 API 已经可用,大家有什么想补充的请跟帖。 使用原则 欢迎用于 APP、插件、数据分析研究等 禁止用于以内容填充为目的应用或站点 公共约定 对于 ..

📝 社区客户端 API 文档

本贴最后更新于 206 天前,其中的信息可能已经渤澥桑田

概述

该文档主要面向社区客户端开发者,如果你想开发一个移动端 APP 的话请仔细阅读该文档。如果你喜欢写博客,想要将博客和社区进行联动的话请参考内容 API 开放,欢迎各位独立博客主进行连接

目前以下列出的 API 已经可用,大家有什么想补充的请跟帖。

使用原则

公共约定

对于请求和响应的一些公共约定在这里统一进行描述。

HTTP

User-Agent

不要使用 HTTP 客户端自带的 UA,请一定要自定义 UA,推荐格式 {App}/{Ver},比如 Solo/v2.9.5。如果不自定义 UA,请求将会被社区的流量监控系统阻断,并且对发起请求的 IP 进行一定时间的拦截。

鉴权

列表分页

响应结构

响应中的 HTTP body 为 JSON 结构,固定包含 3 个字段:

{
    "sc": 0,
    "msg": "",
    "data": null
}

其中:

注意事项

帖子

获取最新帖子列表

GET 方法:

获取领域帖子列表

获取标签帖子列表

示例:

获取帖子详情

发布帖子

获取帖子详情用于更新

更新帖子

回帖

发布回帖

领域

获取领域列表

获取领域详情

标签

获取标签列表

获取标签详情

用户

根据用户名获取用户详情

根据用户序号获取用户详情

获取用户帖子列表

获取用户回帖列表

获取用户关注帖子列表

获取用户关注用户列表

获取用户关注标签列表

获取用户收藏帖子列表

获取用户关注者列表

通知

获取未读计数

获取收到的回帖消息列表

获取收到的回复消息列表

获取提及我的消息列表

获取我关注的消息列表

获取我的积分消息列表

获取同城广播消息列表

获取系统公告消息列表

榜单

获取新注册用户列表

获取粉丝榜

登录

密码验证

两步验证

登出

系统

获取系统当前时间

展开
  • 黑客派

    黑客派是 B3log 开源社区的线上论坛,这里主要汇聚了程序员和设计师。HacPai 分别取 Hacker / Painter 的头三个字母组成,源自《黑客与画家》。

    我们正在构建一个小众社区,大家在这里相互信任,以平等 • 自由 • 奔放的价值观进行分享交流。最终,希望大家能够找到与自己志同道合的伙伴,共同成长。

    更多细节请浏览黑客派简介

    313 引用 • 6409 回帖 • 692 关注
  • Sym

    Sym 是一个用 Java 实现的现代化社区(论坛 / 社交网络 / 博客)平台,“下一代的社区系统,为未来而构建”。黑客派就是使用该系统搭建的 ❤️

    417 引用 • 4072 回帖 • 644 关注
  • API

    应用程序编程接口(Application Programming Interface)是一些预先定义的函数,目的是提供应用程序与开发人员基于某软件或硬件得以访问一组例程的能力,而又无需访问源码,或理解内部工作机制的细节。

    47 引用 • 293 回帖
  • 客户端
    4 引用 • 87 回帖
优质回帖
  • lijp 1 赞同      

    补充:
    ①感谢、like、unlike、收藏、查看的接口;
    ②相关帖子的列表接口;
    ③搜索的接口;(不知道能不能直接在移动端集成 Algolia)
    ④书单的接口;

    其他的一些很好玩,但我觉得暂时没必要(此刻、财富排行及消费排行)

  • Vanessa 1 赞同      

    0e060c04352a4a4092e3fab5bab6b873-image.png

    这几个怕是要提供一下。还有消息推送哟。

  • Vanessa 1 赞同      

    • 文章详情页面评论需要下拉刷新,重新给一个接口
    • 文章详情页面返回 html

74 回帖   
请输入回帖内容...
  • lijp 1 赞同  

    补充:
    ①感谢、like、unlike、收藏、查看的接口;
    ②相关帖子的列表接口;
    ③搜索的接口;(不知道能不能直接在移动端集成 Algolia)
    ④书单的接口;

    其他的一些很好玩,但我觉得暂时没必要(此刻、财富排行及消费排行)

  • 其他回帖
  • ZephyrJung  

    看不下去了,挽尊……

    1 回复
  • 88250      

    谢谢,还是你好 😂

  • Angonger

    到此一游

  • 查看更多回帖