API - 深蓝阅读 | BlueReader

什么是深蓝阅读API? API列表 申请验证key 谁在使用? 深蓝阅读首页

1. 什么是深蓝阅读API?

通过调用深蓝阅读提供的接口,可以将深蓝阅读的热门内容、自己的订阅等展现在自己的网站或博客上,丰富网站的内容。

2. API列表

热门内容

http://api.bluereader.org/hot //默认返回最新10条热门内容

http://api.bluereader.org/hot/(标签名称) //默认返回符合当前标签(如"网络安全","电影")的最新10条热门内容,注:添写时不包含"()",下同

http://api.bluereader.org/hot/limit/(n) //(n)为1-50的数字,添写/limit/(n)可返回1-50固定数量的内容

 

//返回数据(JSON):

[
  {
    "title":"***",         //内容标题
    "description":"***",   //内容简介
    "link":"http://***",   //内容链接
    "pubDate":"1小时前",    //人性化的发布时间
    "pubTime":"1412001122" //内容发布时间戳
  }
  ,...
]

用户的订阅列表

http://api.bluereader.org/user/auth/(auth)/rss

//默认返回用户的所有订阅,(auth)为验证key,需要申请

 

//返回内容(JSON格式):

[
  {
    "rssId":"***",              //订阅唯一标识ID
    "domain":"www.***.com",     //订阅的域名
    "homepage":"***",           //订阅的主页链接
    "title":"***",              //订阅标题
    "userNum":"http://***",     //添加此订阅的人数
    "updateTime":"1412001122",  //订阅更新时间
    "error":"0",                //订阅是否可用,0可用/1不可用
    "lastPubTime":"1412001122", //订阅的内容最新发布时间
    "link":"***"                //订阅链接地址
  }
  ,...
]

用户的单个订阅详情

http://api.bluereader.org/user/auth/(auth)/rss/(rssId)

//(rssId)为数字,即订阅的唯一ID

http://api.bluereader.org/user/auth/(auth)/rss/(rssId)/limit/(n)

//(n)为1-50的数字,添写/limit/(n)可返回1-50固定数量的内容列表

 

//返回内容(JSON格式):

[
  {
    "rssId":"***",              //订阅唯一标识ID
    "domain":"www.***.com",     //订阅的域名
    "homepage":"***",           //订阅的主页链接
    "title":"***",              //订阅标题
    "userNum":"http://***",     //添加此订阅的人数
    "updateTime":"1412001122",  //订阅更新时间
    "error":"0",                //订阅是否可用,0可用/1不可用
    "lastPubTime":"1412001122", //订阅的内容最新发布时间
    "link":"***",               //订阅链接地址
    "articles":                 /* 订阅的内容列表 */
    [
      {
        "title":"***",          //内容标题
        "link":"***",           //内容链接
        "pubTime":"***"         //内容发布时间戳
      }
      ,...
    ]
  }
  ,...
]

用户所有订阅里的最新内容(即将开放,目前需申请)

http://api.bluereader.org/user/auth/(auth)/articles

//默认返回用户所有订阅里的最新10篇内容

http://api.bluereader.org/user/auth/(auth)/articles/limit/(n)

//(n)为1-50的数字,添写/limit/(n)可返回1-50固定数量的内容列表

http://api.bluereader.org/user/auth/(auth)/articles/category/(category)

//(category)为分类名称(对应用户的订阅分类),添加(category)可对返回内容进行过滤

http://api.bluereader.org/user/auth/(auth)/articles/category/(category)/limit/(n)

(n)为1-50的数字,添写/limit/(n)可返回1-50固定数量的内容列表

http://api.bluereader.org/user/auth/(auth)/articles/keywords/(keywords)

//(keywords)为过滤标签,添加(keywords)可对返回内容进行关键字过滤

http://api.bluereader.org/user/auth/(auth)/articles/keywords/(keywords)/limit/(n)

(n)为1-50的数字,添写/limit/(n)可返回1-50固定数量的内容列表

 

//返回内容(JSON格式):

[
  {
    "title":"***",          //内容标题
    "link":"***",           //内容链接
    "pubTime":"***"         //内容发布时间戳
  }
  ,...
]

3. 申请验证key

请将您在深蓝阅读注册的用户、网站、简介等信息发送到邮箱 [email protected] 进行申请,感谢使用深蓝阅读。

4. 谁在使用?