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

Rate limiting

注：只針對(duì)標(biāo)準(zhǔn)API端口，高級(jí)API不在討論范圍內(nèi)。

每個(gè)用戶(hù)或每個(gè)應(yīng)用程序

標(biāo)準(zhǔn)API的速率限制主要基于每個(gè)用戶(hù)，或者更準(zhǔn)確地說(shuō)，基于每個(gè)用戶(hù)的訪問(wèn)令牌。如果一個(gè)方法允許每個(gè)端口接收15個(gè)請(qǐng)求，那么它允許每個(gè)訪問(wèn)令牌訪問(wèn)該窗口15個(gè)請(qǐng)求。（大白話就是限制15個(gè)請(qǐng)求就只能允許你訪問(wèn)15次）

使用僅應(yīng)用程序身份驗(yàn)證時(shí)，將全局確定整個(gè)應(yīng)用程序的速率限制。如果一個(gè)方法允許每個(gè)端口接收15個(gè)請(qǐng)求，那么它允許您代表應(yīng)用程序?yàn)槊總€(gè)窗口發(fā)出15個(gè)請(qǐng)求。此限制與每個(gè)用戶(hù)的限制完全分開(kāi)考慮。

15分鐘間隔

速率限制分為15分鐘間隔。所有端口在請(qǐng)求時(shí)都需要身份驗(yàn)證。

有兩種initial buckets可用于GET請(qǐng)求：每15分鐘15個(gè)請(qǐng)求，每15分鐘180個(gè)請(qǐng)求。

HTTP頭部和響應(yīng)代碼

使用HTTP頭可以了解在給定的速率限制下，應(yīng)用程序在剛剛使用的方法上的狀態(tài)。

Http Headers

上圖是HTTP Headers and Response Codes部分，可以看到有三個(gè)參數(shù)可以查看當(dāng)前請(qǐng)求過(guò)程所在的“一輪請(qǐng)求計(jì)數(shù)”總共的次數(shù)、剩余的次數(shù)、下次重新計(jì)數(shù)的時(shí)間戳。

注意，HTTP頭是上下文的。當(dāng)使用app-only auth的身份驗(yàn)證時(shí)，它們指示應(yīng)用程序上下文的速率限制。使用user-based auth的身份驗(yàn)證時(shí)，它們指示該用戶(hù)應(yīng)用程序上下文的速率限制。

當(dāng)應(yīng)用程序超過(guò)給定標(biāo)準(zhǔn)API終結(jié)點(diǎn)的速率限制時(shí)，API將返回一個(gè)HTTP 429“太多請(qǐng)求”響應(yīng)代碼，并在響應(yīng)正文中返回以下錯(cuò)誤：

返回錯(cuò)誤

為了更好地知道可用的速率限制，請(qǐng)考慮定期使用GET application/rate_limit_status方法（這兩個(gè)方法后面會(huì)介紹）。

「Janebook」的原創(chuàng)文章更好的解釋了這幾個(gè)參數(shù)的使用，在此處貼出部分內(nèi)容：

以“GET followers/ids”接口為例，文檔顯示15分鐘為一個(gè)計(jì)數(shù)循環(huán)，15分鐘內(nèi)單個(gè)用戶(hù)（不同用戶(hù)請(qǐng)求沒(méi)有測(cè)試）使用“user auth”最多請(qǐng)求15次該接口。計(jì)數(shù)從每一輪循環(huán)的第一次發(fā)出請(qǐng)求開(kāi)始計(jì)算本輪循環(huán)的15分鐘，對(duì)應(yīng)x-rate-limint-reset參數(shù)，即為本輪首次發(fā)出請(qǐng)求時(shí)的時(shí)間戳+1560對(duì)應(yīng)的數(shù)字。x-rate-limit-limit對(duì)于此接口來(lái)說(shuō)為15（不變的固定值），一輪循環(huán)中加入已經(jīng)請(qǐng)求了N次，則對(duì)應(yīng)的x-rate-limit-remaining為15-N次。*

GET and POST請(qǐng)求限制

從系統(tǒng)中讀取的速率限制（GET）是根據(jù)每個(gè)用戶(hù)和每個(gè)應(yīng)用程序定義的，而寫(xiě)入系統(tǒng)（POST）的速率限制僅在用戶(hù)帳戶(hù)級(jí)別定義。換句話說(shuō)，對(duì)于讀取速率限制，請(qǐng)考慮以下情況：

這部分看不懂也沒(méi)問(wèn)題，大概意思是：

對(duì)于user auth來(lái)說(shuō)，如果一個(gè)用戶(hù)X，授權(quán)了APPa及APPb，分別生成了TokenA、TokenB，如果使用TokenA請(qǐng)求了某個(gè)端口（例如GET friends/list）n次，那么在本輪循環(huán)計(jì)數(shù)結(jié)束前使用TokenA與TokenB請(qǐng)求該端口的剩余次數(shù)之和為“15-n”。

避免速率受限的技巧

緩存

如果您希望大量使用API，請(qǐng)將響應(yīng)存儲(chǔ)在您的應(yīng)用程序或網(wǎng)站中。例如，請(qǐng)勿嘗試在網(wǎng)站登錄頁(yè)面的每個(gè)頁(yè)面加載上調(diào)用Twitter API。而是不經(jīng)常調(diào)用API，并將響應(yīng)加載到本地緩存中。當(dāng)用戶(hù)訪問(wèn)您的網(wǎng)站時(shí)，加載結(jié)果的緩存版本。

優(yōu)先考慮活動(dòng)用戶(hù)

如果您的站點(diǎn)跟蹤許多Twitter用戶(hù)（例如，獲取其當(dāng)前狀態(tài)或有關(guān)Twitter使用情況的統(tǒng)計(jì)信息），請(qǐng)考慮僅請(qǐng)求最近登錄您站點(diǎn)的用戶(hù)的數(shù)據(jù)。

反正最好的突破頻率限制的方法還是充錢(qián)=。=