本系列是對(duì)推特開發(fā)者文檔進(jìn)行的翻譯,以便幫助開發(fā)人員使用API接口,難免有些地方存在不足,還請(qǐng)諒解。
每個(gè)開發(fā)人員都應(yīng)該知道的事情
有不同的API類別
標(biāo)準(zhǔn)(免費(fèi))Twitter API包括REST API和Streaming API。
企業(yè)(收費(fèi)訂閱)API包括經(jīng)過(guò)過(guò)濾的firehose,歷史搜索和參與API,用于更深入的數(shù)據(jù)分析,偵聽(tīng)和其企業(yè)業(yè)務(wù)應(yīng)用程序。
高級(jí)(隨用隨付)API包含可靠且價(jià)格合理的企業(yè)API版本,可讓您的業(yè)務(wù)隨您的使用而增長(zhǎng)。
另外,有些API系列(例如Ads API)要求將應(yīng)用程序列入白名單才能使用它們。
該API旨在成為RESTful資源
除Streaming API和帳戶活動(dòng)Web鉤子外,Twitter API端點(diǎn)嘗試符合代表性狀態(tài)轉(zhuǎn)移(REST)的設(shè)計(jì)原則。Twitter API使用JSON數(shù)據(jù)格式進(jìn)行響應(yīng)(在某些情況下還用于請(qǐng)求)。
推特ID可能會(huì)破壞Javascript
為確保安全起見(jiàn),請(qǐng)使用id_str字段(而不是id)。Web瀏覽器/Javascript解釋器/JSON使用者可能會(huì)大量使用基于整數(shù)的id,因此建議使用字符串表示。
一天可以進(jìn)行多少次呼叫和更改是有限制的
API的使用受到速率的限制,在寫入/創(chuàng)建/刪除端點(diǎn)上具有基于帳戶的其他合理使用限制,以保護(hù)Twitter免受濫用。
參數(shù)有一定的期望
一些API方法采用可選參數(shù)或必需參數(shù)。使用參數(shù)進(jìn)行請(qǐng)求時(shí)請(qǐng)記住:
·參數(shù)值應(yīng)轉(zhuǎn)換為UTF-8和URL編碼。
·頁(yè)面的參數(shù)從1開始,而不是0。
注意,一些API方法將根據(jù)客戶端發(fā)送的HTTP頭返回不同的結(jié)果。如果參數(shù)和HTTP頭都可以控制相同的行為,則參數(shù)將優(yōu)先。
有分頁(yè)限制
REST API限制
客戶端可以通過(guò)user_timeline REST API方法的page和count參數(shù)訪問(wèn)理論上最多3200個(gè)狀態(tài)。其他timeline方法理論上最多有800個(gè)狀態(tài)。超過(guò)限制的請(qǐng)求將導(dǎo)致?tīng)顟B(tài)代碼為200的答復(fù),并導(dǎo)致所請(qǐng)求格式的空結(jié)果。Twitter仍然維護(hù)著一個(gè)用戶發(fā)送的所有Tweets的數(shù)據(jù)庫(kù)。但是,為了確保性能,在API調(diào)用上設(shè)置了這個(gè)限制。
Twitter API庫(kù)幾乎適用于所有語(yǔ)言