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和kai??xin001.
返回結果
如果出錯,返回對應的HTTP狀態碼及錯誤信息,例如:
否則,HTTP狀態碼為200,返回JSON格式的相關分享數據,例如:
其中accountUid是分享會員在平臺裡的會員ID,statusUrl則是分享的微博的URL,destination則是微博的ID。注意目前只有新浪微博和搜狐微博會返回詳細分享數據,其他的平臺detail部分內容為空。