本系列是對推特開發(fā)者文檔進行的翻譯,以便幫助開發(fā)人員使用API接口,難免有些地方存在不足,還請諒解。
每個開發(fā)人員都應該知道的事情
有不同的API類別
標準(免費)Twitter API包括REST API和Streaming API。
企業(yè)(收費訂閱)API包括經(jīng)過過濾的firehose,歷史搜索和參與API,用于更深入的數(shù)據(jù)分析,偵聽和其企業(yè)業(yè)務應用程序。
高級(隨用隨付)API包含可靠且價格合理的企業(yè)API版本,可讓您的業(yè)務隨您的使用而增長。
另外,有些API系列(例如Ads API)要求將應用程序列入白名單才能使用它們。
該API旨在成為RESTful資源
除Streaming API和帳戶活動Web鉤子外,Twitter API端點嘗試符合代表性狀態(tài)轉(zhuǎn)移(REST)的設計原則。Twitter API使用JSON數(shù)據(jù)格式進行響應(在某些情況下還用于請求)。
推特ID可能會破壞Javascript
為確保安全起見,請使用id_str字段(而不是id)。Web瀏覽器/Javascript解釋器/JSON使用者可能會大量使用基于整數(shù)的id,因此建議使用字符串表示。
一天可以進行多少次呼叫和更改是有限制的
API的使用受到速率的限制,在寫入/創(chuàng)建/刪除端點上具有基于帳戶的其他合理使用限制,以保護Twitter免受濫用。
參數(shù)有一定的期望
一些API方法采用可選參數(shù)或必需參數(shù)。使用參數(shù)進行請求時請記住:
·參數(shù)值應轉(zhuǎn)換為UTF-8和URL編碼。
·頁面的參數(shù)從1開始,而不是0。
注意,一些API方法將根據(jù)客戶端發(fā)送的HTTP頭返回不同的結(jié)果。如果參數(shù)和HTTP頭都可以控制相同的行為,則參數(shù)將優(yōu)先。
有分頁限制
REST API限制
客戶端可以通過user_timeline REST API方法的page和count參數(shù)訪問理論上最多3200個狀態(tài)。其他timeline方法理論上最多有800個狀態(tài)。超過限制的請求將導致狀態(tài)代碼為200的答復,并導致所請求格式的空結(jié)果。Twitter仍然維護著一個用戶發(fā)送的所有Tweets的數(shù)據(jù)庫。但是,為了確保性能,在API調(diào)用上設置了這個限制。
Twitter API庫幾乎適用于所有語言