thinksns微博系统接口文档

http://www.choujone.com/blog/1345181758477

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