更新时间:2010-04-12
JavaEye目前提供如下的API,更多API将会陆续推出。
(文档编写中...)
用户认证
目前所有的API都需要认证,验证方式为
HTTP Basic Access Authentication。
如果你的系统有curl,可以用curl来非常简单地来尝试这些API,以用户认证的API为例子:
- curl -u 用户名:密码 http://api.iteye.com/api/auth/verify
curl -u 用户名:密码 http://api.iteye.com/api/auth/verify
认证成功返回JSON格式字符串:
{"domain": "博客子域名", "name": "用户名", "id": 用户ID}
认证失败返回字符串:
error.auth.fail
对应的HTTP Response Code为401
为了避免暴力破解密码,如果某个IP的连续认证错误超过6次,在一个小时内将会无法进行认证,返回字符串:
error.auth.over.limit
对应的HTTP Response Code为401
为了避免对服务器过大压力,限制单个IP的单个用户请求,每小时不能超过300次,超过的用户在一小时内调用任何API都会返回字符串:
error.api.over.limit
对应的HTTP Response Code为400
闲聊API
基本数据参数说明 返回值中如果包含闲聊记录,统一都是JSON格式的字符串,有如下属性
- id: 闲聊ID
- created_at: 创建时间
- body: 闲聊内容
- user: 闲聊发布者,属性如下
- name: 用户名
- logo: 头像文件路径(最大宽高150x150),如果要获取缩略图,路径为xxx-thumb.jpg(最大宽高48x48)
- domain: 用户的博客子域名
- receiver: 闲聊接收者,属性同user,可能为空
- reply_to_id: 回复某条闲聊ID,可能为空
- via: 通过什么发布
id: 闲聊ID
created_at: 创建时间
body: 闲聊内容
user: 闲聊发布者,属性如下
name: 用户名
logo: 头像文件路径(最大宽高150x150),如果要获取缩略图,路径为xxx-thumb.jpg(最大宽高48x48)
domain: 用户的博客子域名
receiver: 闲聊接收者,属性同user,可能为空
reply_to_id: 回复某条闲聊ID,可能为空
via: 通过什么发布
返回值每页显示30条闲聊记录
可选参数的统一定义:
last_id: 只抓取大于这个id的闲聊记录
page: 抓取第N页记录
闲聊一下 URL: http://api.iteye.com/api/twitters/list
返回值: 包含闲聊记录的JSON格式字符串(数组格式)
可选参数: last_id, page
我的闲聊 URL: http://api.iteye.com/api/twitters/my
返回值: 包含闲聊记录的JSON格式字符串 (数组格式)
可选参数: last_id, page
@我的 URL: http://api.iteye.com/api/twitters/replies
返回值: 包含闲聊记录的JSON格式字符串(数组格式)
可选参数: last_id, page
全站闲聊 URL: http://api.iteye.com/api/twitters/all
返回值: 包含闲聊记录的JSON格式字符串(数组格式)
可选参数: last_id, page
发布新闲聊 URL: http://api.iteye.com/api/twitters/create
返回值: 新发布成功的闲聊记录的JSON格式字符串
必需参数:
body: 闲聊内容
可选参数:
reply_to_id: 回复某条闲聊的id
via: 通过什么发布
删除闲聊 URL: http://api.iteye.com/api/twitters/destroy
返回值: 成功删除的闲聊id,如果失败,返回"error.record.not.found"字符串
通过ID获取闲聊记录 URL: http://api.iteye.com/api/twitters/show
必需参数:
id: 你需要获取的闲聊id,如果要一次获取多个记录,可以用逗号分隔传递(id=1,2,3),最多支持30个id
返回值:
找不到任何记录,返回"error.record.not.found"字符串
获取一条记录,返回该闲聊记录的JSON格式字符串
获取多条记录,多条闲聊记录的JSON格式字符串(数组格式)
用户收藏API
基本数据参数说明 返回值中如果包含收藏记录,统一都是JSON格式的字符串,有如下属性
- id: 收藏ID
- url: 收藏的链接
- title: 收藏的标题
- description: 描述
- cached_tag_list:标签(多个标签用半角英文逗号隔开)
- public: 代表是公开收藏还是私人收藏
- created_at: 添加该收藏的时间
id: 收藏ID
url: 收藏的链接
title: 收藏的标题
description: 描述
cached_tag_list:标签(多个标签用半角英文逗号隔开)
public: 代表是公开收藏还是私人收藏
created_at: 添加该收藏的时间
列出用户收藏 URL: http://api.iteye.com/api/user_favorites/list
返回值: 包含用户收藏的JSON格式字符串(数组格式)
注意:目前是全部列出用户的收藏数据,如果用户收藏非常多的话,速度可能会比较慢,建议一次获取以后进行缓存。以后可能会加入分页的功能。
新加收藏 URL: http://api.iteye.com/api/user_favorites/create
返回值: 添加成功的用户收藏的JSON格式字符串
必需参数:
url: 收藏文章的链接
title: 收藏文章的标题
可选参数:
description: 描述
tag_list: 标签(多个标签用半角英文逗号隔开)
share: 是否公开和大家共享,用false代表不公开(默认公开)
更新收藏 URL: http://api.iteye.com/api/user_favorites/update
返回值: 更新成功的用户收藏的JSON格式字符串,如果找不到对应id对应的数据,返回"error.record.not.found"字符串
必需参数:
id: 更新用户收藏的ID
其他参数同“新加收藏”
删除收藏 URL: http://api.iteye.com/api/user_favorites/destroy
返回值: 删除成功的记录id,如果找不到对应id对应的数据,返回"error.record.not.found"字符串
必需参数:
id: 删除用户收藏的ID
站内短信API
基本数据参数说明 返回值中如果包含站内短信记录,统一都是JSON格式的字符串,有如下属性
- id: 短信ID
- created_at: 创建时间
- system_notice: 是否系统短信的标记
- has_read: 是否已读的标记
- attach: 是否有附件的标记
- title: 短信标题
- plain_body: 短信内容(已经去除HTML标签)
- sender: 短信发送者,属性如下
- name: 用户名
- logo: 头像文件路径(最大宽高150x150),如果要获取缩略图,路径为xxx-thumb.jpg(最大宽高48x48)
- domain: 用户的博客子域名
- receiver: 闲聊接收者,属性同sender
id: 短信ID
created_at: 创建时间
system_notice: 是否系统短信的标记
has_read: 是否已读的标记
attach: 是否有附件的标记
title: 短信标题
plain_body: 短信内容(已经去除HTML标签)
sender: 短信发送者,属性如下
name: 用户名
logo: 头像文件路径(最大宽高150x150),如果要获取缩略图,路径为xxx-thumb.jpg(最大宽高48x48)
domain: 用户的博客子域名
receiver: 闲聊接收者,属性同sender
收件箱 URL: http://api.iteye.com/api/messages/inbox
返回值: 包含闲聊记录的JSON格式字符串(数组格式,每页15条记录)
可选参数:
last_id: 只抓取大于这个id的站内短信记录
page: 抓取第N页记录
注意:调用这个方法以后,如果返回值中有包含未读短信,在下一次调用的时候将会标记为已读
发送站内短信 URL: http://api.iteye.com/api/messages/create
返回值: 新发送成功短信的JSON格式字符串,如果失败,返回"error.具体的错误信息"字符串
必需参数:
title: 短信标题
body: 短信内容
receiver_name: 收件人用户名
回复站内短信 URL: http://api.iteye.com/api/messages/reply
返回值: 新回复成功短信的JSON格式字符串,如果失败,返回"error.具体的错误信息"字符串
必需参数:
id: 要回复的短信ID
title: 短信标题
body: 短信内容
删除站内短信 URL: http://api.iteye.com/api/messages/destroy
返回值: 成功删除的短信id,如果失败,返回"error.record.not.found"字符串
必需参数:
id: 要删除的短信ID
疑难问题
1、用curl测试成功,但是用Java编写程序发现失败,说拒绝连接
通过应用程序访问API的时候,请在User-Agent信息上面声明:"JavaEye API Client"
分享到:
相关推荐
NULL 博文链接:https://ago520.iteye.com/blog/754087
NULL 博文链接:https://ago520.iteye.com/blog/814571
JavaEye的API使用帮助
复制进eclipse即可用。main方法测试
NULL 博文链接:https://javaeye-hua.iteye.com/blog/1274093
NULL 博文链接:https://msnvip.iteye.com/blog/351818
Android 中文API 合集(102 篇)
jQuery1.2.6库(压缩版-产品,未压缩版-学习),还有中文API手册(CHM,HTML),共340K,保证好用. 你也可以到我的BOLG下载:http://elf8848.javaeye.com/blog/241135
经过2个半星期的努力… lordhong和mqqqvpppm, 轩[kop]一起开发了JavaEye的android客户端alpha版本. 当前版本包括闲聊, 站内短信, 和收藏. 功能安装当前API上的描述来开发
Ext3.0英文API.CHM 压制:大漠穷秋 QQ群:88403922 个人主页:damoqiongqiu.javaeye.com 欢迎交流 转载来的请大家分享 开发必备
最近由lordhong发起开发的JavaEye Android 客户端正式发布,这个开源项目通过调用JavaEye公开的API,实现了JavaEye闲聊, 站内短信, 和收藏功能,方便JavaEye会员在手机上浏览和使用JavaEye网站。这个项目已经发布到...
NULL 博文链接:https://zkh43javaeye.iteye.com/blog/953956
CacheXMLLinuxEclipsejunit...鉴于csdn的blog的不稳定, 及混乱的编辑器, 和无上传功能, 遂决定彻底投诚javaeye的blog. 数月前整理的一个东西, 作为cache的扫盲文档.参考了它的官方文档. 对ehcache感兴趣的兄台可以参考.
Open Flash Chart - Open Flash Chart 是一个 Flash 图表组件,很容易安装,提供以下语言的API: PHP, Perl, Python, Java, Ruby on Rails, and .Net 来控制图表。 • AmCharts - AmCharts 是一个动画交互Flash...
找资料:http://lamono.javaeye.com/blog/49135 拷贝xalan.jar和serialize.jar到/WEB-INF/lib,问题解决 FCKeditor-java没有很好的解决中文问题需要我们修改它的源代码后重新编译打包打包过程如下: 1 新建一个...
logo 设计不会,就这样先凑合了写道 ...广告服务 JavaEye黑板报 关于我们 联系我们 友情链接 © 2003-2010 JavaEye.com. 上海炯耐计算机软件有限公司版权所有 [ 沪ICP备05023328号 ] 您正在搜索 Java博客系统 [ X ]关
近日,需要做一个关于Service的Mapping, 因为排版的需要,需要一个TreeTable,我们用的js框架是dojo,但是定制dojo(1.4)很困难,且我们这个tree table不需要太多的功能,所以最终决定自己实现一个,API类似于dojo的...
6.Action中访问servlet API 3 7.Action访问资源文件 3 8.资源文件_各国代码 4 9.将struts.xml分开 4 10全局结果result 4 11模型驱动 4 12.创建拦截器 5 13表单提交中文乱码问题 5 14.Jsp不能识别EL 5 15.自定义...
(Hibernate网站上的用户论坛有一个中文版面,JavaEye也有Hibernate中文版面,您可以在那里交流问题与经验。) <br>商业开发、产品支持和Hibernate培训可以通过JBoss Inc.获得。(请查阅:...