本系列是對推特開發者文檔進行的翻譯,以便幫助開發人員使用API接口,難免有些地方存在不足,還請諒解。
關於如何獲得一個推特開發者賬號請看此貼:
推特開發者賬號的申請
或
搜索微信公衆號 twitterDeveloper 獲得幫助
每個開發人員都應該知道的事情
有不同的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調用上設置了這個限制。