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

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

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

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

POST請(qǐng)求

下表中描述的標(biāo)準(zhǔn)API速率限制是指POST端口。這些速率限制僅適用于標(biāo)準(zhǔn)API端口，不適用于高級(jí)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次請(qǐng)求，則在此期間，您的應(yīng)用程序只能向POST status/retweet/:id端口發(fā)出100次請(qǐng)求。（300-200）

GET請(qǐng)求

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

此限制僅針對(duì)于standard API（標(biāo)準(zhǔn)接口）有效。對(duì)于Standard API，無論是post還是get對(duì)應(yīng)的方法接口，均分為user auth和app auth兩種頻率限制。官方文檔中對(duì)OAuth的解釋來說，使用“OAuth 1”認(rèn)證獲取到的token對(duì)應(yīng)的為“user auth”，使用“OAuth2”認(rèn)證的token對(duì)應(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對(duì)應(yīng)四個(gè)參數(shù)，app auth對(duì)應(yīng)兩個(gè)參數(shù)。

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