Xweibo微博API接口说明Xweibo
201 1年6月
目 录
目录
1 接口概述.......................................................................................................................0
2 API调用说明...............................................................................................................0
2.1 参数说明. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .0
2.2 Api访问方式说明. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .0
3 API返回值说明...........................................................................................................1
3.1 返回格式 json. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1
3.2 返回结构 {"rst":返回结果,"errno":结果代码,"err":"错误提示信息"} . . . . . . . . . . 14 错误代码.......................................................................................................................1
4.1 参数检查错误代码. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1
4.2 平台级别错误代码. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2
5 接口介绍.......................................................................................................................2
5.1 微博访问接口. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2
5.1 .1 action.update发布一条微博消息. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2
5.1 .2 action.destroy删除一条微博信息. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3
5.1 .3 action.repost转发一条微博信息. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4
5.1 .4 action.comment对一条微博信息进行评论. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6
5.1 .5 action.comment.destroy删除微博评论. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6
5.1 .6 action.reply 回复微博评论消息. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7
5.2 关注接口. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9
5.2.1 action.createFriendship关注某用户. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9
5.2.2 action.deleteFriendship取消关注或移除粉丝. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .10
5.2.3 action.friendship查看某人是否为指定用户的粉丝. . . . . . . . . . . . . . . . . . . . . . .10
5.3 收藏接口. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11
5.3.1 action.createFavorite添加收藏. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11
5.3.2 action.deleteFavorite删除收藏. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11
5.4 账号接口. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .12
5.4.1 action.updateProfi leImage更改头像. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .12
/)wwwWwQwmMmMMm℃2
Xweibo v21
5.4.2 action.saveProfi le更改个人资料. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .12
5.5 获取下行数据集Timel ine接口. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13
5.5.1 action.unread获取当前用户未读消息数. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13
5.5.2 action.getComments获取指定微博的评论列表. . . . . . . . . . . . . . . . . . . . . . . . . . .13
5.5.3 action.getCounts批量获取评论数和转发数. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1 15
5.5.4 action.clearTip未读消息数清零接口. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1 15
5.6 私信接口. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .16
5.6.1 action.sendDirectMessage发送私信. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .16
5.6.2 action.deleteDirectMessage删除私信. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .16
5.7 用户接口. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .17
5.7.1 action.createBlocks加入黑名单. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .17
5.7.2 action.deleteBlocks删除黑名单. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .17
5.7.3 action.createTags添加标签. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .18
5.7.4 action.deleteTags删除标签. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .18
5.8 其它接口. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .19
5.8.1 action.setting tip个人设置. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .19
5.8.2 action.sinaurl 解析短链接. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .19
5.8.4 action.saveNotice更新提醒设置和tip显示方式. . . . . . . . . . . . . . . . . . . . . . . . . .21
Xweibo微博API接口说明
1 接口概述
Xwe i b o不仅提供了快速、低成本架设微博的解决方案还提供了让第三方调用的API接口。第三方通过调用这些AP I接口可以轻松地为Xweibo推送内容 同时也能够从Xwe i b o获取所需的内容在自有网站上进行展示。
Xwei bo微博AP I接口是一座连接第三方网站与Xwei bo的桥梁。通过它站长可以实现自有站点与Xwe i b o无缝连接进行无障碍的内容共享。
2 API调用说明
2.1参数说明
在请求api的同时 post多以下三个参数ap i_s ign签名值md5(AP I_WB_AKEY.'#' .$ap i_uid.'#' .$ap i_time. '#' .API_WB_SKEY. '#' .$m.'#' .AP
I_KEY);
API_WB_AKEY默认使用申请微博应用的app key
API_WB_SKEY默认使用申请微博应用的app secret
$m是访问ap i的接口名。 比如要访问发微博ap i $m=‘up date’ 。
API_KEY约定加密的keyap i_uid第三方绑定的用户uidap i_t ime 当前请求的时间时间戳。
2.2 Api访问方式说明
某些api允许使用匿名身份或者系统默认帐号进行访问
如果需要使用匿名身份访问部分api
请设置变量 $allow_anonymous的值默认是空数组。 比如
$allow_anonymous = array( ‘getTokenAuthorizeURL’ ) ;
那么接口 getTokenAuthorizeURL就可以使用匿名身份访问
/)wwwWwQwmMmMMm℃0
Xweibo v21
如果需要使用默认帐号访问部分api
请设置变量 $allow_others的值默认是空数组。 比如
$allow_others = array( ‘update’ , ’ comment’ ) ;
那么接口 update和comment就可以使用系统帐号访问
使用这个两种方式访问api api_uid可以为空或一个不存在的uid值。3 API返回值说明
3.1返回格式 json
3.2返回结构 {错误提
示信息"}
1)返回结果 json格式的字符串或单独的字符
2)结果代码正确的返回是 0 错误的返回是一个错误代码
3)错误提示信息方便分析问题。 自定义的或接口本身的错误内容4 错误代码
错误以7位数字表示。比如 1010000前两位表示主类别第二三位表示子类别后三位用来表示错误代码。错误代码分为公共的错误代码和接口特定的错误代码。参数检查错误代码以及平台级别错误属于公共的错误代码如下所示
4.1参数检查错误代码
。
-1-
4.2平台级别错误代码
5 接口介绍
5.1微博访问接口
5.1 .1 action.update发布一条微博消息
4) URL http://server/?m=api/weibo/action.update
5)请求参数
微博/)wwwWwQwmMmMMm℃2
Xweibo v21
6)返回格式
7)接口错误代码
5.1 .2 action.destroy删除一条微博信息
8) URL http://serve r/?m=api/weibo/action.destroy
9)参数列表
10)返回格式
1 1)接口错误代码
5.1 .3 action.repost转发一条微博信息
12)URL http://serve r/?m=api/weibo/action.repost
13)参数列表
14)返回格式
/)wwwWwQwmMmMMm℃4
Xweibo v21
字。
5.1 .4 action.comment对一条微博信息进行评论
16)URL http://server/?m=api/weibo/action.comment
17)参数列表
18)返回格式
TmhHost是一家国内正规公司,具备ISP\ICP等资质,主营国内外云服务器及独立服务器租用业务,目前,商家新上香港三网CN2 GIA线路VPS及国内镇江BGP高防云主机,其中香港三网CN2 GIA线路最低每月45元起;同时对美国洛杉矶CN2 GIA线路高防及普通VPS进行优惠促销,优惠后美国洛杉矶Cera机房CN2 GIA线路高防VPS季付99元起。香港CN2 GIA安畅机房,三网回程CN2 ...
BGP.TO目前针对日本和新加坡服务器进行促销,其中日本东京服务器6.5折,而新加坡服务器7.5折起。这是一家专门的独立服务器租售网站,提供包括中国香港、日本、新加坡和洛杉矶的服务器租用业务,基本上都是自有硬件、IP资源等,国内优化直连线路,机器自动化部署上架,并提供产品的基本管理功能(自助开关机重启重装等)。新加坡服务器 $93.75/月CPU:E3-1230v3内存:16GB硬盘:480GB ...
diyvm怎么样?diyvm商家VPS主机均2GB内存起步,三个地区机房可选,使用优惠码后每月69元起;DiyVM独立服务器开设在香港沙田电信机房,CN2线路,5M带宽,自动化开通上架,最低499元/月,配置是L5630*2/16G内存/120G SSD硬盘。DiyVM是一家成立于2009年的国人主机商,提供的产品包括VPS主机、独立服务器租用等,产品数据中心包括中国香港、日本大阪和美国洛杉矶等,...