推特標(biāo)準(zhǔn)接口API的請求頻率限制說明

本系列是對推特開發(fā)者文檔進(jìn)行的翻譯，以便幫助開發(fā)人員使用API接口，難免有些地方存在不足，還請諒解。

推特標(biāo)準(zhǔn)接口API的請求頻率限制說明

官方文檔為：https://developer.twitter.com/en/docs/basics/rate-limits

POST請求

下表中描述的標(biāo)準(zhǔn)API速率限制是指POST端口。這些速率限制僅適用于標(biāo)準(zhǔn)API端口，不適用于高級API。

注意

每3小時(shí)300個(gè)是POST status/update和POST status/retweet/:id端口的一個(gè)組合限制。在3小時(shí)內(nèi)，你只能發(fā)布300條推文或轉(zhuǎn)發(fā)。

例如，如果您的Twitter應(yīng)用程序在三小時(shí)內(nèi)向POST status/update端點(diǎn)發(fā)出200次請求，則在此期間，您的應(yīng)用程序只能向POST status/retweet/:id端口發(fā)出100次請求。（300-200）

GET請求

此表中描述的標(biāo)準(zhǔn)API速率限制是指GET（read）端口。請注意，圖表中未列出的端口默認(rèn)為每個(gè)已分配用戶15次請求。所有請求窗口的長度為15分鐘。（15分鐘的窗口期可以發(fā)送XX次請求）這些速率限制僅適用于標(biāo)準(zhǔn)API端口，不適用于高級API。

此限制僅針對于standard API（標(biāo)準(zhǔn)接口）有效。對于Standard API，無論是post還是get對應(yīng)的方法接口，均分為user auth和app auth兩種頻率限制。官方文檔中對OAuth的解釋來說，使用“OAuth 1”認(rèn)證獲取到的token對應(yīng)的為“user auth”，使用“OAuth2”認(rèn)證的token對應(yīng)的為“app auth”。另外，使用user auth需要指明consumer_key、consumer_secret、access_token_key、access_token_secret四個(gè)參數(shù)，而app auth只需要指明consumer_key、consumer_secret兩個(gè)參數(shù)。也就是user auth對應(yīng)四個(gè)參數(shù)，app auth對應(yīng)兩個(gè)參數(shù)。

以“GET friends/list”接口為例，文檔顯示15分鐘為一個(gè)計(jì)數(shù)循環(huán)，15分鐘內(nèi)單個(gè)用戶通過“user auth”最多請求15次該接口。計(jì)數(shù)從每一輪循環(huán)的第一次發(fā)出請求開始計(jì)算本輪循環(huán)的15分鐘。