Have you thought about making your own app? Come on, here's your chance

I. Introduction

A few years ago, I developed an application "Duanzile", and it also reached a peak of around 7,000 daily active users at that time. However, due to the problem of funds (short videos are too expensive), I chose to stop the project at that time, until the users later Restart the project after it's gone. Although the project has undergone several major revisions, and it is now 3.0.0, there are only a dozen or so daily active users left.

At the suggestion of a friend, I decided to do a more meaningful thing, open the project interface and data to the outside world, so that friends who love tossing can use these interfaces to make their own applications, of course, including but not limited to developing an Android App, iOS App, Mini Program, H5 App, Flutter App, etc.

My personal homepage is: www.mxnzp.com , if you want to contact me, you can find my contact information here. If you want to connect to this interface, you will definitely encounter many problems, so you can contact me to join the group and discuss together.

2. Introduction to Interface Opening

"Duanzi Le" itself is an application similar to "xx Duanzi", which mainly includes the following functions:

Plain text, pictures and short video types of jokes
Like, comment, favorite and share the content of the paragraph
Achieving a swipe like Douyin to browse short video content
Publish plain text, pictures and short video clips
User attention, fan system
Message system, connected to Jiguang IM and push
Ledou system, point lottery, etc.
...

In addition to some special functions including IM message related, third-party QQ WeChat login and one-click login, the interfaces corresponding to other functions are open, so in theory, you can completely implement another "Duanzile" of your own ( Note: You can connect IM and push by yourself, without letting the backend intervene).

Let’s first briefly show some main pages:

To experience what "Duanzile" is, please click: www.pgyer.com/rmjK , and it can also give you a reference for page jumping. If you connect all the interfaces, you can roughly develop such an APP.

3. Before docking

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

3.1 请求接口的HOST地址

请求接口的HOST地址为：tools.cretinzp.com/jokes

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

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

3.3 调用接口通用的请求头

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

请求头KEY	请求头VALUE	请求头含义
token	登录成功之后接口会返回token，你需要存储在本地，每次请求带上	用户凭证信息
uk	设备的唯一id，请尽量保证针对设备唯一，长度32以内	用户设备唯一标识
channel	请直接填写cretin_open_api	渠道来源
app	拼接版本号版本标识和系统版本，用;分开，例如 1.0.0;1;10，代表版本号1.0.0，版本标识1，系统为Android 10，其他也类似	app信息
device	拼接版本设备信息，设备品牌和设备型号，用;分开，例如HUAWEI;CDY-AN00	设备信息

3.4 接口返回数据的格式

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

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

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

3.5 其他的一些说明

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

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

项目中所用到的图片和视频资源均上传到七牛云上面，所以你需要集成七牛云的SDK，上传文件的时候，请调用相关接口获取到七牛云上传token：

tools.cretinzp.com/jokes/doc.h…

然后再进行上传文件。具体操作可参考链接（这个是Andorid的使用链接，其他端请自行查询）：

developer.qiniu.com/kodo/1236/a…
3、接口中返回的视频和图片链接进行了加密，如何解密

链接使用了简单的对称加密，请联系我或者加入交流群，我会告知大家加密方式和加密秘钥，解析完即可获取真实的视频链接。
4、...

四、开放接口说明

接口文档已经上传，可直接查看在线接口文档，包含65个API接口。这里对每个页面需要的接口进行一个阐述，接口地址为：tools.cretinzp.com/jokes/doc.h…