使用新浪微博開(kāi)放平臺api同步微博內容至自己網(wǎng)站(使用微博API的簡(jiǎn)便方法,你已經(jīng)有了嗎?)
優(yōu)采云 發(fā)布時(shí)間: 2021-11-15 19:05使用新浪微博開(kāi)放平臺api同步微博內容至自己網(wǎng)站(使用微博API的簡(jiǎn)便方法,你已經(jīng)有了嗎?)
Twitter API 將為每個(gè)請求返回適當的 HTTP 狀態(tài)。例如,當請求一個(gè)不存在的用戶(hù)信息時(shí),API 將返回 404 Not Found;當請求未通過(guò)身份驗證和授權時(shí),API 將返回 401 Not Authorized 狀態(tài)。
使用 API 的簡(jiǎn)單方法
如果您的系統上安裝了 curl,那么您已經(jīng)擁有了一個(gè)非常強大的使用微博 API 的工具。下面是一個(gè)使用curl的例子,很簡(jiǎn)單:
未經(jīng)授權訪(fǎng)問(wèn)public_timeline:curl
獲取好友的時(shí)間線(xiàn),使用身份驗證:curl -u email:password
僅獲取標題信息: curl --head email:password
用戶(hù)狀態(tài)相關(guān)方法
狀態(tài)/public_timeline
返回未設置隱私的用戶(hù)的最后 20 條消息(必須具有自定義用戶(hù)頭像)。這種方法不需要身份認證。
地址:
支持格式(format):xml、json、rss、atom
參數列表:
沒(méi)有。
狀態(tài)/朋友_時(shí)間線(xiàn)
返回最近 24 小時(shí)內經(jīng)過(guò)身份驗證的用戶(hù)及其好友的最新 20 條更新消息。
地址:
支持格式(format):xml、json、rss、atom
參數列表:
since_id:可選參數(微博信息ID)。僅返回ID大于since_id(晚于since_id)的微博信息內容。
例子:
max_id:可選參數(微博信息ID)。返回ID不大于max_id的微博信息內容。
例子:
計數:可選參數。每次返回的最大記錄數,不能超過(guò)200條,默認為20.
例子:
頁(yè)面:可選參數。返回結果的頁(yè)碼。注意:有分頁(yè)限制。根據用戶(hù)關(guān)注的帖子數,通常最多返回1000條最新的微博分頁(yè)內容,默認為1條
例子:
狀態(tài)/用戶(hù)時(shí)間線(xiàn)
返回最近 24 小時(shí)內由經(jīng)過(guò)身份驗證的用戶(hù)更新的最新 20 條消息。同樣,給定的 userIdOrName 參數可用于請求其他用戶(hù)的最新消息更新。API 可能未經(jīng)過(guò)身份驗證。
地址:
支持的格式(format):xml、json、rss、atom
參數列表:
id:可選參數。根據指定的用戶(hù)UID或微博昵稱(chēng)返回微博信息。
例子:
user_id:可選參數。用戶(hù)UID主要用于區分用戶(hù)UID和微博昵稱(chēng)。有歧義時(shí),尤其是微博昵稱(chēng)是數字時(shí),與用戶(hù)Uid有歧義。
例子:
screen_name:可選參數。微博昵稱(chēng),主要用于在出現歧義時(shí)區分用戶(hù)UID和微博昵稱(chēng)。
例子:
since_id:可選參數(微博信息ID)。只返回id大于since_id(晚于since_id)的微博信息內容
例子:
max_id:可選參數(微博信息ID)。返回ID不大于max_id的微博信息內容。
示例: 示例:
計數:可選參數。每次返回的最大記錄數,最多返回200條記錄,默認為20條。
例子:
頁(yè)面:可選參數。分頁(yè)返回。注意:返回最多 200 頁(yè)的內容。
例子:
狀態(tài)/提及
顯示最近給用戶(hù)的20條回復消息(消息前綴為@username)。此 API 僅對經(jīng)過(guò)身份驗證的用戶(hù)開(kāi)放。無(wú)論其他用戶(hù)是否設置了隱私,向其他用戶(hù)索取收到的回復信息列表都是非法的。
地址:
支持格式(format):xml、json、rss、atom
參數列表:
因為_(kāi)id??蛇x參數。返回 ID 大于值 since_id(晚于 since_id)的提及項。
例子:
最大 ID??蛇x參數。返回 ID 不大于 max_id(時(shí)間不晚于 max_id)的提及。
例子:
數數??蛇x參數。每次返回的最大記錄數(即頁(yè)面大?。?,不大于200條,默認為20條。
例子:
頁(yè)??蛇x參數。返回結果的頁(yè)碼。注意:有分頁(yè)限制。
例子:
用戶(hù)留言相關(guān)方法
狀態(tài)/顯示
返回指定Id的消息,返回的消息收錄作者信息。
訪(fǎng)問(wèn)地址:或
{ID}
支持格式(format):xml、json
參數列表:
ID。必選參數(微博信息ID),獲取發(fā)布的微博ID,如果ID不存在,返回空
例子:
狀態(tài)/更新
更新已驗證用戶(hù)的消息必須收錄 content 參數,并且必須在 POST 模式下請求。成功后,以指定格式返回當前消息。
地址:
支持的格式(format):xml、json
參數列表:
地位。必填參數,待更新微博信息。必須完成 URLEncode。信息內容超過(guò)140個(gè)漢字。如果為空,將返回 400 錯誤。
in_reply_to_status_id??蛇x參數,要回復的微博消息的@ID。此參數僅在微博內容以@username 開(kāi)頭時(shí)才有意義。
緯度 可選參數,緯度,當前微博發(fā)布的地理位置,有效范圍-90.0到+90.0,+表示北緯。地理位置只有在用戶(hù)設置中 geo_enabled=true 時(shí)才有效。
長(cháng)??蛇x參數,經(jīng)度。有效范圍為 -180.0 到 +180.0,+ 表示東經(jīng)。
狀態(tài)/破壞
要根據指定的 id 刪除消息,經(jīng)過(guò)身份驗證的用戶(hù)必須是消息的作者。
地址:
支持格式(format):xml、json
參數列表:
id 必須是要刪除的消息的 id,例如:
或者
用戶(hù)界面
用戶(hù)/節目
顯示指定用戶(hù)的擴展信息,需要指定用戶(hù)的id或顯示名。擴展信息包括用戶(hù)的頁(yè)面設置、微博數量等,第三方應用的開(kāi)發(fā)者可以根據這些信息為用戶(hù)提供合適的話(huà)題。
注意:此API調用請求必須由合法微博用戶(hù)發(fā)出,無(wú)論是向自己或他人請求擴展信息。
地址:
支持的格式(format):xml、json
參數列表:
ID。用戶(hù) UID 或微博昵稱(chēng)。
示例:或
用戶(hù)身份。指定用戶(hù)UID,主要用于區分用戶(hù)UID和微博昵稱(chēng)。當存在歧義時(shí),尤其是用戶(hù)賬號為數字時(shí),與用戶(hù)Uid存在歧義。
例子:
屏幕名稱(chēng)。指定微博昵稱(chēng),主要用于在出現歧義時(shí)區分用戶(hù)UID和微博昵稱(chēng)。
例子:
狀態(tài)/朋友
返回認證用戶(hù)的好友列表,其中收錄每個(gè)用戶(hù)當前的微博信息。這個(gè)方法也可以用來(lái)請求其他用戶(hù)的好友列表,通過(guò)下面指定的方法傳遞id參數。
地址:
支持的格式(format):xml、json
參數列表:
ID??蛇x參數。獲取UID或微博昵稱(chēng)
例子:
用戶(hù)身份??蛇x參數。需要獲取的UID
例子:
屏幕名稱(chēng)??蛇x參數。微博昵稱(chēng)待獲取
例子:
光標??蛇x參數。單個(gè)頁(yè)面只能收錄 100 個(gè)監視列表。為了得到更多,游標默認從-1開(kāi)始。您可以通過(guò)增加或減少光標來(lái)獲得更多。如果沒(méi)有下一頁(yè),next_cursor 返回 0
'S觀(guān)察名單
例子:
例子:
數數??蛇x參數。每次返回的最大記錄數(即頁(yè)面大?。?,不大于200條,默認返回20條。
例子:
狀態(tài)/追隨者
返回經(jīng)過(guò)身份驗證的用戶(hù)的訂閱者,收錄每個(gè)訂閱者的當前消息。就像好友一樣,只需將好友地址中的好友替換為關(guān)注者即可,其他所有參數,包括參數,都不需要更改。他們都是一樣的。
地址:
支持的格式(format):xml、json
參數列表:
ID??蛇x參數。獲取粉絲的UID或微博昵稱(chēng)
示例:或
用戶(hù)身份??蛇x參數。需要獲取的UID
例子:
屏幕名稱(chēng)??蛇x參數。微博昵稱(chēng)待獲取
例子:
光標??蛇x參數。一個(gè)頁(yè)面只能收錄 100 個(gè)粉絲列表。為了得到更多,游標默認從-1開(kāi)始。您可以通過(guò)增加或減少光標來(lái)獲得更多。如果沒(méi)有下一頁(yè),next_cursor 返回 0
粉絲列表示例: 示例:
數數??蛇x參數。每次返回的最大記錄數(即頁(yè)面大?。?,不大于200條,默認返回20條。
例子:
私信操作方法
direct_messages
返回用戶(hù)的消息列表
地址:
支持格式(format):xml、json、rss、atom
參數列表:
因為_(kāi)id??蛇x參數。返回id大于since_id值(晚于since_id)的私信。
例子:
最大 ID??蛇x參數。返回ID不大于max_id(時(shí)間不晚于max_id)的私信。
例子:
數數??蛇x參數。每次返回的最大記錄數(即頁(yè)面大?。?,不大于200。
例子:
頁(yè)??蛇x參數。返回結果的頁(yè)碼。注意:有分頁(yè)限制。
例子:
直接消息/發(fā)送
返回用戶(hù)的已發(fā)消息列表
地址:
支持格式(format):xml、json、rss、atom
參數列表:
因為_(kāi)id??蛇x參數。返回id大于since_id值(晚于since_id)的私信。
例子:
最大 ID??蛇x參數。返回ID不大于max_id(時(shí)間不晚于max_id)的私信。
例子:
數數??蛇x參數。每次返回的最大記錄數(即頁(yè)面大?。?,不大于200。
例子:
頁(yè)??蛇x參數。返回結果的頁(yè)碼。注意:有分頁(yè)限制。
direct_messages/新
作為認證用戶(hù),向指定的其他用戶(hù)發(fā)送定向消息,必須收錄參數 user 和 text,并且請求必須使用 POST 提交。成功將返回完整的發(fā)送消息,必須收錄參數 user 和 text,并且必須使用 POST 提交。成功將返回完整的發(fā)送消息。
地址:
支持格式(format):xml、json
參數列表:
用戶(hù):user_id 或 screen_name
文本:必需參數。生成的消息內容需要URLEncode,文字大小必須小于300個(gè)漢字
direct_messages/銷(xiāo)毀
使用給定的消息 id,刪除指定的定向消息,經(jīng)過(guò)身份驗證的用戶(hù)只能刪除作為收件人收到的消息。POST 和 GET 方法都可以使用
地址:
支持格式(format):xml、json
參數列表:
ID。必選參數,需要刪除的私信主鍵ID。
例子:
友情操作方法
友誼/創(chuàng )造
在經(jīng)過(guò)身份驗證的用戶(hù)和給定 id 參數指定的用戶(hù)之間創(chuàng )建好友關(guān)系;如果操作執行成功,將返回已添加為好友的用戶(hù)信息,如果執行失敗,將返回失敗狀態(tài)字符串。
地址:
支持格式(format):xml、json
參數列表:
以下參數必須具有其中之一:
ID。必需參數。要關(guān)注的用戶(hù) UID 或微博昵稱(chēng)
示例:或
用戶(hù)身份。必需參數。關(guān)注用戶(hù)的UID主要用于區分用戶(hù)UID和微博昵稱(chēng),造成歧義。
例子:
屏幕名稱(chēng)。必需參數。關(guān)注的微博昵稱(chēng)主要用于區分用戶(hù)UID和微博昵稱(chēng),造成歧義。
例子:
跟隨??蛇x參數。目前不支持。
友誼/破壞
用于取消指定id的用戶(hù)的好友關(guān)系。操作成功時(shí),返回取消好友關(guān)系的用戶(hù),失敗時(shí)返回失敗信息。
地址:
支持格式(format):xml、json
參數列表:
以下參數必須具有其中之一:
ID。必需參數。要取消關(guān)注的用戶(hù) UID 或微博昵稱(chēng)
示例:或
用戶(hù)身份。必需參數。取消關(guān)注用戶(hù)的UID主要用于區分用戶(hù)UID和微博昵稱(chēng),造成歧義。
例子:
屏幕名稱(chēng)。必需參數。取消的微博昵稱(chēng)主要用于區分用戶(hù)UID和微博昵稱(chēng),造成歧義。
例子:
友誼/存在
用于檢查兩個(gè)用戶(hù)之間的關(guān)系是朋友關(guān)系還是關(guān)注關(guān)系。返回彼此跟隨的關(guān)系的結果。例如:A跟B,B不跟A,會(huì )返回對應的格式數據:如xml,true或false
地址:
支持格式:xml、json
參數列表:
用戶(hù)_a。必選參數,需要判斷的用戶(hù)UID
用戶(hù)_b。必選參數,需要判斷的關(guān)注用戶(hù)的UID
友誼/表演
返回兩個(gè)用戶(hù)之間關(guān)系的詳細信息
地址:
支持格式:xml、json
參數列表:
以下參數可以留空,留空則取當前用戶(hù)
源 ID。源用戶(hù) UID
例子:
源屏幕名稱(chēng)。來(lái)源微博昵稱(chēng)
例子:
以下參數必須是可選的:
目標 ID。待判斷的目標用戶(hù)的UID
例子:
目標屏幕名稱(chēng)。目標微博昵稱(chēng)待評
例子:
獲取用戶(hù)列表方法
朋友/ID
用于獲取指定用戶(hù)的好友用戶(hù)id。即你關(guān)注的人的id
地址:
支持格式:xml、json
參數列表:
ID??蛇x參數。獲取好友的UID或微博昵稱(chēng)
示例:或
用戶(hù)身份??蛇x參數。需要獲取的UID
例子:
屏幕名稱(chēng)??蛇x參數。微博昵稱(chēng)待獲取
例子:
光標??蛇x參數。單個(gè)頁(yè)面只能收錄 5000 個(gè) ID。為了得到更多,游標默認從-1開(kāi)始。您可以通過(guò)增加或減少光標來(lái)獲取更多觀(guān)察列表。
示例: 示例:
數數??蛇x參數。每次返回的最大記錄數(即頁(yè)面大?。?,不大于5000條,默認返回500條。
例子:
關(guān)注者/ID
用于獲取指定用戶(hù)被關(guān)注的用戶(hù)id。
地址:
支持格式:xml、json
參數列表:
ID??蛇x參數。獲取好友的UID或微博昵稱(chēng)
示例:或
用戶(hù)身份??蛇x參數,要獲取的UID
例子:
屏幕名稱(chēng)??蛇x參數,要獲取的微博昵稱(chēng)
例子:
光標??蛇x參數。單個(gè)頁(yè)面只能收錄 5000 個(gè) ID。為了得到更多,游標默認從-1開(kāi)始。您可以通過(guò)增加或減少光標來(lái)獲取更多觀(guān)察列表。
例子:
例子:
數數??蛇x參數。每次返回的最大記錄數(即頁(yè)面大?。?,不大于5000條,默認返回500條。
例子:
用戶(hù)賬號方式
帳戶(hù)/verify_credentials
如果用戶(hù)認證成功,則http狀態(tài)為200;如果沒(méi)有,將返回 401 狀態(tài)和錯誤消息。該方法用于判斷用戶(hù)的身份是否合法。
地址:
支持格式:xml、json
參數列表:
帳戶(hù)/update_profile
自定義微博頁(yè)面參數。只會(huì )修改參數更新項。
地址:
支持格式:xml、json
參數列表:
以下參數必須有一個(gè)或多個(gè),且參數值為字符串。進(jìn)一步的限制,請參考下面各參數的說(shuō)明。
姓名。昵稱(chēng),可選參數。不超過(guò)20個(gè)漢字
性別 性別,可選參數。男,女,女。
省 可選參數。參考省市代碼表
city 是一個(gè)可選參數。參考省市代碼表,1000不限
描述??蛇x參數。不超過(guò)160個(gè)漢字。


