开始用api前必?br />
(l读q一节，你将掌握大多数经验丰富的开发者知?
每一个开发者都必须知道的事?br />
(每个twitter api开发者都必须知道的基知识)
0QFAQ的内?/strong>
当你开始开发的时候，熟悉FAQ的内容ƈ且知道问题所在?br />
1Qtwitter其实有两份api
目前twitter api存在两个分立的版本。大部分的开发者都Lq两份api来完成开发。将REST和Search的api分离是不理想的，完全是由于历史原因。如果开 发周期允许的话，我们打算合ƈREST和Search的api完善之。api预览里的前言部分说明了这D历双Ӏ?br />
2Q你不能无限ơ地调用
api的用频率是有限制的。你可以阅读《我们有个雷》（q个名字好雷哦）来学习下?br />
3Q此api是完全基于HTTP?/strong>
从twitter api索数据的Ҏ需要发送GETh。提交、修Ҏ者删除数据用POSTh。DELETEh也是可用来删除数据。如果你没有使用正确的方法请求数据，使用ҎHTTPҎ的apip回一个错误。HTTP的返回（有链接）是丰富多彩的?br />
4Q此api是RESTful的源
twitter api企图保按照REST的原则来设计。只需要简单修改你h的扩展上的格式就可以取到你所指定的格式。本文档指明了对每一U方法都有哪些格式是可用 的。目前api支持的数据格式有QXML、JSON、RSS、Atom联合供稿格式。有个别Ҏ只支持其中的某些格式?br />
5Q参数都有确定的期望?/strong>
有些apiҎ有必选的和可选的参数。在发vh的时候要注意两g事情Q?br />
1.参数值必Lutf8~码Qƈ且加上urlencode?br />
2.页的v始值是1不是0
在twitter api中有两个Ҏ的参敎ͼ
1. callbackQ仅在返回格式是JSON的时候用，用这个参数指定一个回调函数来包装你的q回。例如：? ?amp;callback=myFancyFunction在你的请求上Q将会返回：myFancyFunction(…)。此参数只能包含字母数字 和下划线Q其他非法的字符会丢弃?br />
2. suppress_response_codesQ当出现q个参数的时候，所有的q回都将?00的结果返?甚至是错误的时候。这个参数的存在是ؓ了解 决js和flash会拦截所有非200的返回这个问题。一旦用这个参敎ͼ要判断错误就只能依靠解析q回的信息体。请心使用Q因为错误信息可能会改变?br />
前面提到q，api有些Ҏ通过发送不同的HTTP头可以得C同的l果。用参数和HTTP头可以得到同L效果Ӟ优先使用参数?br />
6Q分限?/strong>
REST API的限?br />
使用旉UREST APIQ客L通过page和count参数最多可h3200条状态。超q这个值将q回一?00状态值ƈ且ؓI的所h格式数据。twitterq维 护了一个包含一个用户发出的所有tweets的数据库。尽如此，Z保|站的性能Q做q样人工的限制是恰当的?br />
Search API的限?br />
使用Search APIQ客L通过page和rpp参数最多可h1500条状态。一ơ请求走个数量将会返?00状态和所h格式的空倹{这个h工限制对保搜烦 pȝ的性能是恰当的。我们还依靠在允许搜索的更新上指定一个时间来限制了搜索烦引的范围。当前这个限制是大约一个月的样子，但因为每天增加的用户用户不得 不动态羃减?br />
7Q编码媄响到状态发送的字数
twitter api支持utf-8~码。请注意括号已l被实体~码Q就是编码了html的关键字Q，以预防用JSON API输出的嵌入式用户被跨站式脚本d。编码的实体算入这140个字W的限制中。当hXMLӞq回是utf-8~码的。所有不在标准ASCII? 围内的符号和字符都将被{义成HTML实体?br />
8Q用twitter api你所有需要的是命o?/strong>
如果你的pȝ里有curlQ那你已l拥有了最好的使用twitter api的工兗这有一些例子：
1.使用RSS格式取到公共旉U，不需要认证：curl http://twitter.com/statuses/public_timeline.rss
2.使用XML格式取到所有你follow的h的更斎ͼ需要认证：curl -u username:password http://twitter.com/statuses/friends_timeline.xml
3.仅查?中的头信息：curl –head -u username:password http://twitter.com/statuses/friends_timeline.xml
4.发送一个状态ƈ且取得JSONq回Qcurl -u username:password -d status=”your message here” http://twitter.com/statuses/update.json
学习更多相关的curl和apiL候翻译?br />
9Q这里有几乎每一U编E语a的twitter api?/strong>
C里创Z许多的api库ƈ且乐于分享?br /> API概述
(q去、现在和来的twitter api)
twitter api包含了两部分Q这完全是由于历史原因。最初的时候Summize公司是一家独立的公司专门ltwitter数据提供搜烦功能。Summize后来? 收购Q更名ؓTwitter Search。更名网站很ҎQ但要完全整合Twitter Search和它的api到Twitter的底层代码却很难。统一api已经被我们提上日E，但Search api和REST api会作ؓ独立的实体一直到资源允许?br />
twitter REST api允许开发者得到核心的twitter数据。这包括更新旉Q状态数据，用户信息。Search api提供l开发者与Twitter Search和趋势数据。开发者对于这两者需要注意的是频率限制和输出格式的媄响?br />
惛_习更多的apiҎ和数据，请阅?twitter api技术文（q没译）?br />
其们公示目前的缺陷和改进情况。当前的~陷和改q事可以看issue list。长期目标会记录在\U图文中。（有两个连接没有译Q?br />
API会定期更新ƈ增加新的功能。偶会L一些功能。所有这些更新都会在以下的地方公布：
* @twitterapi
* Google group
* Changelog
频率限制
Qؓ什么api会有限制以及会对应用开发带来什么媄响）
twitter api只允许客L在一定时间里调用有限的次数。这两种api的策略不太一栗?br /> REST API 限制
默认一时内只能请求REST API 100ơ。REST APIq有Z账号和IP的限制。需要n份验证的apih记验证的用户敎ͼ而不需要n份验证的h则记IP数?br /> 频率限制仅适用于用HTTP GETҎh信息的方法。而用HTTP POST向twitter提交内容的方法不受此限制Q例如statuses/updateҎ。另外，haccount /rate_limit_status Ҏ不算。ؓ了保持健康用阻止垃圾信息，q些不受限制的方法还是会受到每天更新和follow数的限制?
]]>