thinksns微博系統接口文檔(轉）

ThinkSNS開源微博系統，是智士的開源社交平臺。採用PHP+MySQL技術平臺，微博+應用的產品模式，同時擁有iphone、 android客戶端、wap、3G版界面。經過應用、插件、風格包等豐富的擴展機制能夠後臺關閉和開啓各類功能。是創建社交網站、微博平臺、移動互聯網 創業的首選。

下面是我整理的微博接口調用說明：

api調用說明

獲取認證token

用戶名密碼獲取(須要post方式)

index.php?app=api&mod=Oauth&act=authorize&uid=xxx&passwd=xxx    

uid能夠是用戶id或者email 

可是uid和passwd均爲加密字符串

如下接口，都須要oauth_token和oauth_token_secret(認證以後獲得的oauth_token和oauth_token_secret)

****************用戶api******************************

獲得用戶資料，同時也將返回用戶的最新發布的微博

index.php?app=api&mod=User&act=show

*******************微博***************************

since_id微博最小編號 默認：空

max_id 微博最大編號 默認：空

page 分頁：頁碼 默認：1

count 分頁：每頁數量 默認：20

user_id 其餘用戶編號 默認：空

user_name 用戶暱稱 默認：空， 與user_id傳遞一個就能夠了

id 微博編號 默認：0

獲取最新更新的公共微博消息

index.php?app=api&mod=Statuses&act=public_timeline

參數：

since_id,

max_id,

count,

page

獲取當前用戶所關注用戶的最新微博信息

index.php?app=api&mod=Statuses&act= friends_timeline

參數：

since_id, 

max_id, 

count, 

page

獲取用戶發佈的微博信息列表

index.php?app=api&mod=Statuses&act=user_timeline

參數：

user_id, 

user_name, 

since_id, 

max_id, 

count, 

page

獲取@當前用戶的微博列表

index.php?app=api&mod=Statuses&act=mentions

參數：

since_id, 

max_id, 

count, 

page

獲取當前用戶發送及收到的評論列表

index.php?app=api&mod=Statuses&act=comments_timeline

參數：

since_id, 

max_id, 

count, 

page

獲得單條微博

index.php?app=api&mod=Statuses&act=show

參數：

id

獲取當前用戶發出的評論

index.php?app=api&mod=Statuses&act=comments_by_me

參數：

since_id, 

max_id, 

count, 

page

獲取當前用戶收到的評論

index.php?app=api&mod=Statuses&act=comments_receive_me

參數：

since_id, 

max_id, 

count, 

page

獲取指定微博的評論列表

index.php?app=api&mod=Statuses&act=comments

參數：

id,

since_id, 

max_id, 

count, 

page

發佈一條微博

index.php?app=api&mod=Statuses&act=update

參數：

content 內容,

from 來自哪裏,

上傳一張圖片並返回圖片地址

index.php?app=api&mod=Statuses&act=uploadpic

參數：

pic 圖片,

發佈一個圖片微博

index.php?app=api&mod=Statuses&act=upload

參數：

content 內容,

pic 圖片,

from 來自哪裏,

刪除一條微博

index.php?app=api&mod=Statuses&act=destroy

參數：

id 微博編號,

對一個微博發一條評論

index.php?app=api&mod=Statuses&act=comment

參數：

reply_comment_id 回覆 評論的ID,

weibo_id 回覆 微博的ID,

comment_content 回覆內容,

transpond 是否同是發佈一條微博,

from 來自哪裏,

轉發一條微博

index.php?app=api&mod=Statuses&act=repost

參數：

reply_data 給xx同時評論的數組對象(此處傳過來的是微博的ID),

content 轉發內容,

transpond_id 轉發的微博ID,

from 來自哪裏,

用戶關注列表

index.php?app=api&mod=Statuses&act=following

參數：

user_id, 

user_name, 

since_id, 

max_id, 

count, 

page

用戶粉絲列表

index.php?app=api&mod=Statuses&act=followers

參數：

user_id, 

user_name, 

since_id, 

max_id, 

count, 

page

搜索微博

index.php?app=api&mod=Statuses&act=search

參數：

key, 

since_id, 

max_id, 

count, 

page

搜索用戶

index.php?app=api&mod=Statuses&act=searchuser

參數：

key

since_id, 

max_id, 

count, 

page

*********************信息api*************************

用戶的最新n條私信，幷包含發送者和接受者的ID,姓名,頭像

index.php?app=api&mod=Message&act=inbox

參數：

type all/is_read/is_unread, 

since_id, 

max_id, 

count, 

page, 

order DESC/ASC

當前用戶發送的最新私信列表

index.php?app=api&mod=Message&act=outbox

參數：

order,

since_id,

max_id, 

count, 

page

當前登錄用戶的私信詳情

index.php?app=api&mod=Message&act=show

參數：

show_cascade 顯示級聯,

id

發送私信

index.php?app=api&mod=Message&act=create

參數：

to_uid,

title,

content

回覆私信

index.php?app=api&mod=Message&act=reply

參數：

id,

content,

刪除私信

index.php?app=api&mod=Message&act=destroy

參數：

message_id

*******************朋友************************

關注某用戶

index.php?app=api&mod=Friendships&act=create

參數：

user_id

返回值：unfollow：沒有關注；eachfollow：互相關注；havefollow：已經關注

取消關注

index.php?app=api&mod=Friendships&act=destroy

參數：

user_id

獲取關注詳情

index.php?app=api&mod=Friendships&act=show

參數：

user_id

*********************微博收藏*************************

當前用戶的收藏列表

index.php?app=api&mod=Favorites&act=index

參數：

since_id, 

max_id, 

count, 

page

添加收藏

index.php?app=api&mod=Favorites&act=create

參數：

id

刪除一個收藏信息

index.php?app=api&mod=Favorites&act=destroy

參數：

id

當前用戶是否收藏了給定微博

index.php?app=api&mod=Favorites&act=isFavorite

參數：

id