想没想过自己做个APP？来，机会来了

一、前言

几年前我开发了一个应用《段子乐》，并在当时也达到了日活7000左右的高峰，不过因为资金的问题（短视频太烧钱），在当时选择了停运项目，直到后面用户都散去之后才重启项目。虽然说项目进行了几次大的改版，现在已经3.0.0了，但是日活却只剩百十来个了。

在朋友的建议下，我决定做一个更有意义的事情，将项目接口和数据进行对外开放，让爱折腾的朋友可以用这些接口做一个自己的应用，当然包括但不仅限于开发一个 Android App，iOS App，小程序，H5应用，Flutter应用等等。

我的个人主页为：www.chiniurou.com ，如果你想联系我，在这里可以找到我的联系方式。如果你希望对接此接口，那么你一定会遇到很多问题，所以你可以联系我加群，一起讨论。

二、接口开放简介

《段子乐》本身是一个类似《xx段子》的应用，主要包含以下功能： 关注里面有的

• 纯文，图片和短视频类型的段子
• 对段子内容的点赞，评论，收藏和分享
• 实现类似抖音一样划一划浏览短视频内容
• 发布纯文，图片和短视频段子
• 用户关注，粉丝体系
• 消息系统，对接了极光IM和推送
• 乐豆系统，积分抽奖等等
• ...

本次开放除了一些特殊功能包括IM消息相关，第三方QQ微信登录和一键登录之外，其他功能所对应的接口都开放，所以理论上你完全可是实现一个另一个自己的《段子乐》（注：IM和推送你可以自己对接，不让后端介入）。

先大致展示下一些主要的页面：

具体体验一下什么是《门诊病历》 ，也可以给你一个页面跳转的参考，如果对接完所有接口，你可以大致开发出这么一个APP。

三、对接之前

对接接口之前，有些约定要提前告知。开放接口文档已托管到github，后续肯定会有很多新增和修改，将会同步在github上，而不会更新此文章，所以请提前收藏该地址，你甚至可以点个star：

3.1 请求接口的HOST地址

请求接口的HOST地址为：www.chiniurou.com

3.2 获取开放API接口调用凭证

此项目对外开放只针对自己人，所以你需要是RollApi的用户，搜索微信小程序【Roll地盘】，点击我的页面，选择【做个段子应用】，可获取到一个专属的project_token（如果你之前没有绑定过手机号，需要先绑定手机号），获取到这个凭证之后，请妥善保管，并在每次调用任意开放api接口的时候，在请求头中加入一个key-value，key为project_token，value为你刚刚申请的值。

3.3 调用接口通用的请求头

在你调用的每个接口中，请包含如下请求头信息【必须，后台会强校验】：

3.4 接口返回数据的格式

接口返回的数据结构如下，后台能保证只要是请求到了后端，每个接口都会返回这种格式：

• 其中code代表接口返回的状态码，当code=200，标识此接口请求成功，当code=202代表用户登录状态过期，也就代表你本地的token过期了，此时你需要清除本地的登录状态，让用户重新登录。
• msg是当code不为200时候的错误信息，你可以将此信息提示给用户。
• data是该请求的实体数据，具体返回什么格式取决于每个接口本身。

{
  "data": null,
  "msg": "数据返回成功",
  "code": 200
}
复制代码

3.5 其他的一些说明

• 1、如何查看发送成功的验证码

  接口中有发验证码的接口，当然我没有真的给你的手机号发送一条验证码，否则我短信费也顶不住。当你调用接口发送成功之后，你可以进入【Roll地盘】小程序，然后点击《我的》，然后点击《做个段子应用》，然后点击《查看短信验证码》，就可以查看近期发送的所有验证码信息了；另外一种方式，你可以关注《Cretin的开发之路》公众号，然后输入#13即可查看对应手机号的验证码信息了。