软件下载 | 资讯教程 | 最近更新 | 下载排行 | 一键转帖 | 发布投稿
您的位置:最火下载站 > 免费资源 > 免费大全 > Twitter API中文文档,为开发扩展提供服务

Twitter API中文文档,为开发扩展提供服务

  目前的国内的微博客很多,不少微博客都提供Open API,然而,很多微博提供的API和Twitter的API有一些或多或少的差别,调用格式上并不完全相同。

  我建议所有提供API的微博客系统,都将各自的API统一为Twitter的API调用格式,例如目前较有影响的开源微博系统StatusNet(Laconica)的API格式就完全兼容Twitter,这种统一API对于开发者和用户都有很大的好处。对于开发者,针对某一个微博的应用可以快速移植到另一个微博,节省开发时间。对于用户,用户可以自定义客户端应用程序,只要换一下API地址,就能使用同一个应用程序,来访问各个不同的微博。例如目前很多人通过StatusNet的客户端来访问Twitter一样,使用起来很方便。

  Twitter的API具体是什么格式的呢?根据Twitter API文档和新浪微博开放平台的文档,这里提供了一个Twitter API的中文翻译文档,供开发者们参考。

Twitter开放API文档

  Twitter通过API的方式开放一些应用接口,这篇文档用来介绍Twitter目前开放的接口,为希望开发基于Twitter服务扩展的工具或应用的开发人员提供技术和文档服务。

  认证

  除了部分API(如:公共时间线 ( public timeline ) )外,所有的API方法都必须要求用户认证,所有的返回都与认证用户相关。例如,尝试获取一个设置为私密的且不是您的好友的用户信息时,将会返回失败状态。

  Twitter目前仅支持HTTP Basic Authentication验证机制。当使用HTTP Basic Authentication时,请使用您在Twitter注册的“用户名”作为Session或Cookie的“用户名”部分的内容。

  多状态[RESTFull]结果传输

  Twitter API力求根据用户特定的请求返回对应特定格式的数据,您可以发现我们提供的API中有一个重要的便利之处,通过简单的更改URI中的文件后缀名,您可以获得您想要的返回结果的格式,这篇文档中将说明每个方法中有哪些格式可以用。

  Twitter目前支持以下的四种数据返回格式:XMLJSONRSS、Atom,您可以在每次请求时使用不同的请求方法指定不同的返回结果。

  参数

  一些API接受可选和必须的参数,当参数可用时,我们会在接下来的文档中提到这些参数。注意:当传送复杂字串时,请一定先将字串编码为UTF-8格式,并再做一次URL编码 ( Encode )。

  HTTP请求

  除非特意指明,Twitter的开放API通过HTTP GET方式的调用,需要提交信息或传送私密消息时使用POST方法。

  以下将说明API返回的信息格式的组成,一些API将返回与用户请求“内容”相关的信息,而有一些将返回与客户端发送的“HTTP头信息”相关的一些信息。例如,多数支持since参数的方法,同样会对HTTP头中的If-Modified-Since这个 HTTP头 感兴趣。需要注意的是,当某些行为既可以通过参数又可以通过HTTP头进行控制时,优先接受通过参数方式设定的值。

  当请求返回数据时,返回数据的编码统一为UTF-8格式,且我们会将一些外部符号编码为HTML实体(&#number; 或&text)格式。

  限制

  每一个客户端每小时最多允许150次请求。

  HTTP状态码

  Twitter API会对每次请求返回合适的HTTP状态。例如,当请求一个不存在的用户信息时,API会返回404 Not Found;当一次请求没有被认证并授权时,API会返回401 Not Authorized状态。 

  使用API的简便方法

  如果您的系统安装有curl,您已经有了一个非常强大的使用微博 API的工具。以下是使用curl的例子,非常简单: 

  非授权情况下访问public_timeline: curl http://api.twitter.com/statuses/public_timeline.xml

  获取朋友的timeline, 使用认证: curl -u email:password http://api.twitter.com/statuses/friends_timeline.xml

  仅获取头部信息: curl --head email:password http://api.twitter.com/statuses/friends_timeline.json

  用户状态相关方法

  statuses/public_timeline

  返回未设置私密的用户 ( 必须有自定义的用户头像 ) 的最近20条消息,该方法不需要身份认证。

  访问地址:http://api.twitter.com/statuses/public_timeline.format

  支持格式(format):xml, json, rss, atom

  参数列表:

  无。

  statuses/friends_timeline

  返回最近24小时内的最新的20条认证用户及其好友更新的消息。

  访问地址:http://api.twitter.com/statuses/friends_timeline.format

  支持格式 ( format ) :xml, json, rss, atom

相关阅读
网友评论
栏目导航
推荐软件