每个开发人员都应该知道的事情
有不同的API类别
标准(免费)Twitter API包括REST API和Streaming API。
企业(收费订阅)API包括经过过滤的firehose,历史搜索和参与API,用于更深入的数据分析,侦听和其企业业务应用程序。
高级(随用随付)API包含可靠且价格合理的企业API版本,可让您的业务随您的使用而增长。
另外,有些API系列(例如Ads API)要求将应用程序列入白名单才能使用它们。
该API旨在成为RESTful资源
除Streaming API和帐户活动Web钩子外,Twitter API端点尝试符合代表性状态转移(REST)的设计原则。Twitter API使用JSON数据格式进行响应(在某些情况下还用于请求)。
推特ID可能会破坏Javascript
为确保安全起见,请使用id_str字段(而不是id)。Web浏览器/Javascript解释器/JSON使用者可能会大量使用基于整数的id,因此建议使用字符串表示。请参阅Twitter ID上的文档。
一天可以进行多少次呼叫和更改是有限制的
API的使用受到速率的限制,在写入/创建/删除端点上具有基于帐户的其他合理使用限制,以保护Twitter免受滥用。
参数有一定的期望
一些API方法采用可选参数或必需参数。使用参数进行请求时请记住:
- 参数值应转换为UTF-8和URL编码。
- 页面的参数从1开始,而不是0。
注意,一些API方法将根据客户端发送的HTTP头返回不同的结果。如果参数和HTTP头都可以控制相同的行为,则参数将优先。
有分页限制
REST API限制
客户端可以通过user_timeline REST API方法的page和count参数访问理论上最多3200个状态。其他timeline 方法理论上最多有800个状态。超过限制的请求将导致状态代码为200的答复,并导致所请求格式的空结果。Twitter仍然维护着一个用户发送的所有Tweets的数据库。但是,为了确保性能,在API调用上设置了这个限制。