泡网api beta版本
因为目前正在做客户端,不得不做一个api出来,想了想客户端源码暂且不说,api还是公布出来吧。
注意:目前只是临时使用的api,路径和请求结果可能会发生变化,稳定之后会整理出完整的文档。
api输出格式为json,参考了github api的一些规则,比如请求列表一般首先是列表的页数,列表项的总数,以及当前页是否加载完所有数据这些信息,然后才是列表本身。
文章列表
url
http://api.jcodecraeer.com/article_list.php
返回
返回格式参考了github的api,以下是示例:
{
"total_count": 5105,
"incomplete_results": false,
"blogs": \[
{
"id": 7777,
"title": "title",
"authorname": "android-luck",
"description": "description",
"content": "empty content in list",
"click": 32,
"comments": 0,
"stow": 0,
"upvote": 0,
"downvote": 0,
"url": "url",
"pubDate": "2017-04-02 22:29:31",
"thumbnail": ""
},
{
"id": 7777,
"title": "title",
"authorname": "android-luck",
"description": "description",
"content": "empty content in list",
"click": 32,
"comments": 0,
"stow": 0,
"upvote": 0,
"downvote": 0,
"url": "url",
"pubDate": "2017-04-02 22:29:31",
"thumbnail": ""
},
......
\]
}
参数
页码参数:p
p参数从0开始,表示第一页,然后依次。。。
如果没有p参数,获得的结果为第一页的数据,也就是p默认为0
示例:http://api.jcodecraeer.com/article_list.php?p=1,获取第二页的数据
一页长度:pleng
pleng默认为20
示例:http://api.jcodecraeer.com/article_list.php?p=1&pleng=15
建议:不指定pleng,使用默认的20,不然每次都要带相同的pleng参数。
各个字段的意思基本可以猜到,就不一一说明了。
文章详情
url
http://api.jcodecraeer.com/article_detail.php
返回
{"id": 5,
"title": "",
"user":
{
"id": 1,
"face": "",
"nickname": ""
},
"description": "",
"content": "",
"click": 113,
"comments": 0,
"stow": 0,
"upvote": 12,
"downvote": 0,
"url": " ",
"pubDate": "2012-03-04 01:23:30",
"thumbnail": ""
}
参数
文章参数:id
即文章id,可以从文章列表信息中得到。
代码列表
可能这是大家最想要的数据了哈。
url
http://api.jcodecraeer.com/code_list.php
返回
{
"total_count": 1391,
"incomplete_results": false,
"items": \[
{
"id": 7792,
"title": "cropiwa",
"user": {
"id": 1,
"face": "",
"nickname": ""
},
"describe": "",
"click": 167,
"comments": 0,
"stow": 10,
"upvote": 0,
"downvote": 0,
"url": "",
"pubDate": "",
"thumbnail": ""
},
......
{
"id": 7788,
"title": "JellyToolbar",
"user": {
"id": 1,
"face": "",
"nickname": ""
},
"describe": "",
"click": 355,
"comments": 0,
"stow": 5,
"upvote": 0,
"downvote": 0,
"url": "http://www.jcodecraeer.com/api/article_detail.php/",
"pubDate": "",
"thumbnail": ""
}
\]
}
参数
代码类别参数:cate,从代码分类列表中获取。
页码参数:p
p参数从0开始,表示第一页,然后依次。。。
如果没有p参数,获得的结果为第一页的数据,也就是p默认为0
代码详情
url
http://api.jcodecraeer.com/code_detail.php
参数
id:代码的id。
相关代码
与某个代码关联的代码列表
url
http://api.jcodecraeer.com/code_relative.php
参数
id:被关联代码的id。
收藏了某篇文章或者代码的用户
http://api.jcodecraeer.com/list_stow_user.php
参数
id:代码或者文章的id
用户基本信息
只列出最基本的信息,头像昵称,粉丝和关注。用户发表的文章动态单独的地址提供。
http://api.jcodecraeer.com/user_profile.php
参数
id:用户的id
今天暂且写这么多,不定期更新