泡网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

今天暂且写这么多,不定期更新