twitter开放api文档

《twitter开放api文档》由会员上传分享，免费在线阅读，更多相关内容在行业资料-天天文库。

1、Twitter开放API文档Twitter通过API的方式开放一些应用接口，这篇文档用来介绍Twitter目前开放的接口，为希望开发基于Twitter服务扩展的工具或应用的开发人员提供技术和文档服务。认证除了部分API(如：公共时间线(publictimeline))外，所有的API方法都必须要求用户认证，所有的返回都与认证用户相关。例如，尝试获取一个设置为私密的且不是您的好友的用户信息时，将会返回失败状态。Twitter目前仅支持HTTPBasicAuthentication验证机制。当使用HTTPBasicAuthentication时，请使用您在

2、Twitter注册的“用户名”作为Session或Cookie的“用户名”部分的内容。多状态[RESTFull]结果传输TwitterAPI力求根据用户特定的请求返回对应特定格式的数据，您可以发现我们提供的API中有一个重要的便利之处，通过简单的更改URI中的文件后缀名，您可以获得您想要的返回结果的格式，这篇文档中将说明每个方法中有哪些格式可以用。Twitter目前支持以下的四种数据返回格式：XML、JSON、RSS、Atom，您可以在每次请求时使用不同的请求方法指定不同的返回结果。参数一些API接受可选和必须的参数，当参数可用时，我们会在接下来的文档

3、中提到这些参数。注意：当传送复杂字串时，请一定先将字串编码为UTF-8格式，并再做一次URL编码(Encode)。HTTP请求除非特意指明，Twitter的开放API通过HTTPGET方式的调用，需要提交信息或传送私密消息时使用POST方法。以下将说明API返回的信息格式的组成，一些API将返回与用户请求“内容”相关的信息，而有一些将返回与客户端发送的“HTTP头信息”相关的一些信息。例如，多数支持since参数的方法，同样会对HTTP头中的If-Modified-Since这个HTTP头感兴趣。需要注意的是，当某些行为既可以通过参数又可以通过HTTP

4、头进行控制时，优先接受通过参数方式设定的值。当请求返回数据时，返回数据的编码统一为UTF-8格式，且我们会将一些外部符号编码为HTML实体（&#number;或&text）格式。限制每一个客户端每小时最多允许150次请求。HTTP状态码TwitterAPI会对每次请求返回合适的HTTP状态。例如，当请求一个不存在的用户信息时，API会返回404NotFound；当一次请求没有被认证并授权时，API会返回401NotAuthorized状态。使用API的简便方法如果您的系统安装有curl，您已经有了一个非常强大的使用微博API的工具。以下是使用curl的

5、例子，非常简单：非授权情况下访问public_timeline：curlhttp://api.twitter.com/statuses/public_timeline.xml获取朋友的timeline,使用认证：curl-uemail:passwordhttp://api.twitter.com/statuses/friends_timeline.xml仅获取头部信息：curl--heademail:passwordhttp://api.twitter.com/statuses/friends_timeline.json用户状态相关方法statuses

6、/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支持格式(form

7、at)：xml,json,rss,atom参数列表：since_id:可选参数（微博信息ID）.只返回ID比since_id大（比since_id时间晚的）的微博信息内容。示例:http://api.twitter.com/statuses/friends_timeline.xml?since_id=12345max_id:可选参数（微博信息ID）.返回ID不大于max_id的微博信息内容。示例:http://api.twitter.com/statuses/friends_timeline.xml?max_id=54321count:可选参数.每次返

8、回的最大记录数，不能超过200，默认20.示例:http://api.twitter.com/