Twitter API中文文檔

2019-07-13 16:46:08 月光博客 分享

  目前的國內的微博客很多,不少微博客都提供Open API,然而,很多微博提供的API和Twitter的API有一些或多或少的差別,調用格式上并不完全相同。

  我建議所有提供API的微博客系統,都將各自的API統一為Twitter的API調用格式,例如目前較有影響的開源微博系統StatusNet(Laconica)的API格式就完全兼容Twitter,這種統一API對于開發者和用戶都有很大的好處。對于開發者,針對某一個微博的應用可以快速移植到另一個微博,節省開發時間。對于用戶,用戶可以自定義客戶端應用程序,只要換一下API地址,就能使用同一個應用程序,來訪問各個不同的微博。例如目前很多人通過StatusNet的客戶端來訪問Twitter一樣,使用起來很方便。

  Twitter的API具體是什么格式的呢?根據Twitter API文檔和新浪微博開放平臺的文檔,這里提供了一個Twitter API的中文翻譯文檔,供開發者們參考。

 

 

  Twitter通過API的方式開放一些應用接口,這篇文檔用來介紹Twitter目前開放的接口,為希望開發基于Twitter服務擴展的工具或應用的開發人員提供技術和文檔服務。

  認證

  除了部分API(如:公共時間線 ( public timeline ) )外,所有的API方法都必須要求用戶認證,所有的返回都與認證用戶相關。例如,嘗試獲取一個設置為私密的且不是您的好友的用戶信息時,將會返回失敗狀態。

  Twitter目前僅支持HTTP Basic Authentication驗證機制。當使用HTTP Basic Authentication時,請使用您在Twitter注冊的“用戶名”作為Session或Cookie的“用戶名”部分的內容。

  多狀態[RESTFull]結果傳輸

  Twitter API力求根據用戶特定的請求返回對應特定格式的數據,您可以發現我們提供的API中有一個重要的便利之處,通過簡單的更改URI中的文件后綴名,您可以獲得您想要的返回結果的格式,這篇文檔中將說明每個方法中有哪些格式可以用。

  Twitter目前支持以下的四種數據返回格式:XMLJSONRSS、Atom,您可以在每次請求時使用不同的請求方法指定不同的返回結果。

  參數

  一些API接受可選和必須的參數,當參數可用時,我們會在接下來的文檔中提到這些參數。注意:當傳送復雜字串時,請一定先將字串編碼為UTF-8格式,并再做一次URL編碼 ( Encode )。

  HTTP請求

  除非特意指明,Twitter的開放API通過HTTP GET方式的調用,需要提交信息或傳送私密消息時使用POST方法。

  以下將說明API返回的信息格式的組成,一些API將返回與用戶請求“內容”相關的信息,而有一些將返回與客戶端發送的“HTTP頭信息”相關的一些信息。例如,多數支持since參數的方法,同樣會對HTTP頭中的If-Modified-Since這個 HTTP頭 感興趣。需要注意的是,當某些行為既可以通過參數又可以通過HTTP頭進行控制時,優先接受通過參數方式設定的值。

  當請求返回數據時,返回數據的編碼統一為UTF-8格式,且我們會將一些外部符號編碼為HTML實體(&#number; 或&text)格式。

  限制

  每一個客戶端每小時最多允許150次請求。

  HTTP狀態碼

  Twitter API會對每次請求返回合適的HTTP狀態。例如,當請求一個不存在的用戶信息時,API會返回404 Not Found;當一次請求沒有被認證并授權時,API會返回401 Not Authorized狀態。 

  使用API的簡便方法

  如果您的系統安裝有curl,您已經有了一個非常強大的使用微博 API的工具。以下是使用curl的例子,非常簡單: 

  非授權情況下訪問public_timeline: curl http://api.twitter.com/statuses/public_timeline.xml

  獲取朋友的timeline, 使用認證: curl -u email:password http://api.twitter.com/statuses/friends_timeline.xml

  僅獲取頭部信息: curl --head email:password http://api.twitter.com/statuses/friends_timeline.json

  用戶狀態相關方法

  statuses/public_timeline

  返回未設置私密的用戶 ( 必須有自定義的用戶頭像 ) 的最近20條消息,該方法不需要身份認證。

  訪問地址:http://api.twitter.com/statuses/public_timeline.format

  支持格式(format)xml, json, rss, atom

  參數列表:

  無。

  statuses/friends_timeline

  返回最近24小時內的最新的20條認證用戶及其好友更新的消息。

  訪問地址http://api.twitter.com/statuses/friends_timeline.format

  支持格式 ( format ) :xml, json, rss, atom

  參數列表:

  since_id: 可選參數(微博信息ID). 只返回ID比since_id大(比since_id時間晚的)的微博信息內容。

  示例: http://api.twitter.com/statuses/friends_timeline.xml?since_id=12345

  max_id: 可選參數(微博信息ID). 返回ID不大于max_id的微博信息內容。

  示例: http://api.twitter.com/statuses/friends_timeline.xml?max_id=54321

  count: 可選參數. 每次返回的最大記錄數,不能超過200,默認20.

  示例: http://api.twitter.com/statuses/friends_timeline.xml?count=5

  page: 可選參數. 返回結果的頁序號。注意:有分頁限制。根據用戶關注對象發表的數量,通常最多返回1,000條最新微博分頁內容, 默認1

  示例: http://api.twitter.com/statuses/friends_timeline.xml?page=3

  statuses/user_timeline

  返回認證用戶最近24小時內最新更新的20條消息,同樣,通過給定userIdOrName參數,可以用來請求其他用戶的最近的消息更新。該API可以不認證。

  訪問地址http://api.twitter.com/statuses/user_timeline.format

  支持格式 ( format ):xml, json, rss, atom

  參數列表

  id: 可選參數. 根據指定用戶UID或微博昵稱來返回微博信息。

  示例: http://api.twitter.com/statuses/user_timeline/12345.xml

  user_id: 可選參數. 用戶UID,主要是用來區分用戶UID跟微博昵稱一樣,產生歧義的時候,特別是在微博昵稱為數字導致和用戶Uid發生歧義。

  示例: http://api.twitter.com/statuses/user_timeline.xml?user_id=1401881

  screen_name:可選參數.微博昵稱,主要是用來區分用戶UID跟微博昵稱一樣,產生歧義的時候。

  示例: http://api.twitter.com/statuses/user_timeline.xml?screen_name=101010

  since_id:可選參數(微博信息ID). 只返回ID比since_id大(比since_id時間晚的)的微博信息內容

  示例: http://api.twitter.com/statuses/user_timeline.xml?since_id=12345

  max_id: 可選參數(微博信息ID). 返回ID不大于max_id的微博信息內容。

  示例: Example: http://api.twitter.com/statuses/user_timeline.xml?max_id=54321

  count: 可選參數. 每次返回的最大記錄數,最多返回200條,默認20。

  示例: http://api.twitter.com/statuses/user_timeline.xml?count=200

  page: 可選參數. 分頁返回。注意:最多返回200條分頁內容。

  示例: http://api.twitter.com/statuses/user_timeline.xml?page=3

  statuses/mentions

聲明:本站部分資源來源于網絡,版權歸原作者或者來源機構所有,如作者或來源機構不同意本站轉載采用,請通知我們,我們將第一時間刪除內容。本站刊載文章出于傳遞更多信息之目的,所刊文章觀點僅代表作者本人觀點,并不意味著本站贊同作者觀點或證實其描述,其原創性及對文章內容的真實性、完整性、及時性本站亦不作任何保證或承諾,請讀者僅作參考。
編輯:果粉
赖子麻将打法技巧 pk105码一期计划 大发快3豹子走势图 浙江快乐12走势图带坐标连线 北京赛pk10现场视频 平码绝密公式规律 广东快乐十分官方下載 新疆时时走势图大全 浙江快乐一定牛彩遗漏查询 重庆时时平台赠送金 优博重庆时时计划群