bShare RESTful分享API以RESTful的形式提供了一種可編程的方式,使站長可以容易的從PHP、Java甚至手機應用中分享內容到各大平臺。
請求鏈接
請求方法
GET/POST認證方法
此API的認證方式有以下兩種:
通過HTTP Basic Authentication中的用戶名、密碼(以英文冒號":"分割)進行認證
通過URL參數中的username和password參數進行認證
注意Basic認證的優先級高于username和password。如果兩者都失敗了,則返回認證失敗。
參數
以下除site外其他所有參數均為可選,但調用時首先必須按前述方式通過認證,然后url,title和summary三者不能同時為空。所有的參數值都必須經過UTF-8格式的URL編碼。
site | 分享的目標平臺(必須) |
username | 用戶在目標平臺的用戶名 |
password | 用戶在目標平臺的密碼 |
publisherUuid | 站長的UUID,不指定則無法追蹤數據 |
url | 分享的鏈接 |
title | 分享的標題 |
summary | 分享的內容摘要 |
pic | 分享的圖片的鏈接,支持新浪微博,搜狐微博,騰訊微博等平臺 |
latitude | 緯度。有效范圍:-90.0到+90.0,+表示北緯(僅支持新浪微博) |
longitude | 經度。有效范圍:-180.0到+180.0,+表示東經(僅支持新浪微博) |
appKey | 你的App Key,和appSecret同時指定后會替換bShare默認的應用“蜂享”(僅支持新浪微博,且App必須有Xauth權限) |
appSecret | 你的App Secret,和appKey同時指定后會替換bShare默認的應用“蜂享”(僅支持新浪微博,且App必須有Xauth權限) |
支持平臺
sinaminiblog,sohuminiblog,renren和kaixin001.
返回結果
如果出錯,返回對應的HTTP狀態碼及錯誤信息,例如:
否則,HTTP狀態碼為200,返回JSON格式的相關分享數據,例如:
其中 accountUid是分享用戶在平臺里的用戶ID,statusUrl則是分享的微博的URL,destination則是微博的ID。注意目前只有新浪微博和搜狐微博會返回詳細分享數據,其他的平臺detail部分內容為空。