Twitter開發者網站上線 可監控API工作狀態
根據新浪科技來自Twitter首屆“Chirp開發者大會”的前方報道,Twitter 平臺經理瑞恩·沙弗(Ryan Saver)在演講時透露,Twitter將發布專門為開發者設計的網站。現在網站已經可以訪問,網址是dev.twitter.com。
此外,瑞恩·沙弗稱API文檔將不再與線上功能有差別,從現在開始將會完全同步,而Twitter將提供一個監測API工作狀況的服務 Watchmouse。
目前Twitter的應用已經超過了10萬,用戶數量超過了1億500萬。本次大會是Twitter首次推出商業收費服務。
Chirp開發者大會是Twitter歷史上首屆開發者大會,時間為北京時間4月14日和15日兩天,地點美國舊金山。
Twitter發展路線圖
專門為開發者設計的網站dev.twitter.com
延伸閱讀
每一個開發者都必須知道的事情(每個Twitter API開發者都必須知道的基礎知識)
0)FAQ的內容
當你開始開發的時候,熟悉FAQ的內容并且知道問題所在。
1)Twitter其實有兩份API
目前Twitter API存在兩個分立的版本。大部分的開發者都混用這兩份API來完成開發。將REST和Search的API分離是不理想的,完全是由于歷史原因。如果開發周期允許的話,我們打算合并REST和Search的API完善之。API預覽里的前言部分說明了這段歷史。
2)你不能無限次地調用
API的使用頻率是有限制的。你可以閱讀《我們有個雷管》(這個名字好雷哦)來學習下。
3)此API是完全基于HTTP的
從Twitter API檢索數據的方法需要發送GET請求。提交、修改或者刪除數據使用POST請求。DELETE請求也是可用來刪除數據。如果你沒有使用正確的方法請求數據,使用特殊HTTP方法的API就返回一個錯誤。HTTP的返回(有鏈接)是豐富多彩的。
4)此API是RESTful的源
Twitter API企圖確保按照REST的原則來設計。只需要簡單修改你請求的擴展上的格式就可以取到你所指定的格式。本文檔指明了對每一種方法都有哪些格式是可用的。目前API支持的數據格式有:XML、JSON、RSS、Atom聯合供稿格式。有個別方法只支持其中的某些格式。
5)參數都有確定的期望值
有些API方法有必選的和可選的參數。在發起請求的時候要注意兩件事情:
1.參數值必須是utf8編碼,并且加上urlencode。
2.翻頁的起始值是1不是0
在Twitter API中有兩個特殊的參數:
1. callback:僅在返回格式是JSON的時候使用,用這個參數指定一個回調函數來包裝你的返回。例如:附加&callback=myFancyFunction在你的請求上,將會返回:myFancyFunction(…)。此參數只能包含字母數字和下劃線,其他非法的字符將會丟棄。
2. suppress_response_codes:當出現這個參數的時候,所有的返回都將以200的結果返回-甚至是錯誤的時候。這個參數的存在是為了解決js和flash會攔截所有非200的返回這個問題。一旦使用這個參數,要判斷錯誤就只能依靠解析返回的信息體。請小心使用,因為錯誤信息可能會改變。
前面提到過,API有些方法通過發送不同的HTTP頭可以得到不同的結果。用參數和HTTP頭可以得到同樣的效果時,優先使用參數。
6)分頁限制
REST API的限制
使用時間線REST API,客戶端通過page和count參數最多可請求3200條狀態。超過這個值將返回一個200狀態值并且為空的所請求格式數據。Twitter還維護了一個包含一個用戶發出的所有tweets的數據庫。盡管如此,為了確保網站的性能,做這樣人工的限制是恰當的。
Search API的限制
使用Search API,客戶端通過page和rpp參數最多可請求1500條狀態。一次請求走出這個數量將會返回200狀態和所請求格式的空值。這個人工限制對確保搜索系統的性能是恰當的。我們還依靠在允許搜索的更新上指定一個時間來限制了搜索索引的范圍。當前這個限制是大約一個月的樣子,但因為每天增加的用戶用戶不得不動態縮減。
7)編碼影響到狀態發送的字。
【編輯推薦】