新浪微博操作类V2
使用前需要先手工调用saetv2.ex.class.php
set_remote_ip(string $ip) : boolean
设置用户IP
SDK默认将会通过$_SERVER['REMOTE_ADDR']获取用户IP，在请求微博API时将用户IP附加到Request Header中。但某些情况下$_SERVER['REMOTE_ADDR']取到的IP并非用户IP，而是一个固定的IP（例如使用SAE的Cron或TaskQueue服务时），此时就有可能会造成该固定IP达到微博API调用频率限额，导致API调用失败。此时可使用本方法设置用户IP，以避免此问题。
| string | $ip | 用户IP |
IP为非法IP字符串时，返回false，否则返回true
public_timeline(integer $page = 1, integer $count = 50, integer $base_app) : array
获取最新的公共微博消息
对应API：statuses/public_timeline
| integer | $page | 返回结果的页码，默认为1。 |
| integer | $count | 单页返回的记录条数，默认为50。 |
| integer | $base_app | 是否只获取当前应用的数据。0为否（所有数据），1为是（仅当前应用），默认为0。 |
home_timeline(integer $page = 1, integer $count = 50, integer $since_id, integer $max_id, integer $base_app, integer $feature) : array
获取当前登录用户及其所关注用户的最新微博消息。
获取当前登录用户及其所关注用户的最新微博消息。和用户登录 http://weibo.com 后在“我的首页”中看到的内容相同。同friends_timeline()
对应API：statuses/home_timeline
| integer | $page | 指定返回结果的页码。根据当前登录用户所关注的用户数及这些被关注用户发表的微博数，翻页功能最多能查看的总记录数会有所不同，通常最多能查看1000条左右。默认值1。可选。 |
| integer | $count | 每次返回的记录数。缺省值50，最大值200。可选。 |
| integer | $since_id | 若指定此参数，则只返回ID比since_id大的微博消息（即比since_id发表时间晚的微博消息）。可选。 |
| integer | $max_id | 若指定此参数，则返回ID小于或等于max_id的微博消息。可选。 |
| integer | $base_app | 是否只获取当前应用的数据。0为否（所有数据），1为是（仅当前应用），默认为0。 |
| integer | $feature | 过滤类型ID，0：全部、1：原创、2：图片、3：视频、4：音乐，默认为0。 |
friends_timeline(integer $page = 1, integer $count = 50, integer $since_id, integer $max_id, integer $base_app, integer $feature) : array
获取当前登录用户及其所关注用户的最新微博消息。
获取当前登录用户及其所关注用户的最新微博消息。和用户登录 http://weibo.com 后在“我的首页”中看到的内容相同。同home_timeline()
对应API：statuses/friends_timeline
| integer | $page | 指定返回结果的页码。根据当前登录用户所关注的用户数及这些被关注用户发表的微博数，翻页功能最多能查看的总记录数会有所不同，通常最多能查看1000条左右。默认值1。可选。 |
| integer | $count | 每次返回的记录数。缺省值50，最大值200。可选。 |
| integer | $since_id | 若指定此参数，则只返回ID比since_id大的微博消息（即比since_id发表时间晚的微博消息）。可选。 |
| integer | $max_id | 若指定此参数，则返回ID小于或等于max_id的微博消息。可选。 |
| integer | $base_app | 是否基于当前应用来获取数据。1为限制本应用微博，0为不做限制。默认为0。可选。 |
| integer | $feature | 微博类型，0全部，1原创，2图片，3视频，4音乐. 返回指定类型的微博信息内容。转为为0。可选。 |
user_timeline_by_id(mixed $uid = NULL, integer $page = 1, integer $count = 50, integer $since_id, integer $max_id, integer $feature, integer $trim_user, integer $base_app) : array
获取用户发布的微博信息列表
返回用户的发布的最近n条信息，和用户微博页面返回内容是一致的。此接口也可以请求其他用户的最新发表微博。
对应API：statuses/user_timeline
| mixed | $uid | 指定用户UID或微博昵称 |
| integer | $page | 页码 |
| integer | $count | 每次返回的最大记录数，最多返回200条，默认50。 |
| integer | $since_id | 若指定此参数，则只返回ID比since_id大的微博消息（即比since_id发表时间晚的微博消息）。可选。 |
| integer | $max_id | 若指定此参数，则返回ID小于或等于max_id的提到当前登录用户微博消息。可选。 |
| integer | $feature | 过滤类型ID，0：全部、1：原创、2：图片、3：视频、4：音乐，默认为0。 |
| integer | $trim_user | 返回值中user信息开关，0：返回完整的user信息、1：user字段仅返回uid，默认为0。 |
| integer | $base_app | 是否基于当前应用来获取数据。1为限制本应用微博，0为不做限制。默认为0。 |
user_timeline_by_name(string $screen_name = NULL, integer $page = 1, integer $count = 50, integer $since_id, integer $max_id, integer $feature, integer $trim_user, integer $base_app) : array
获取用户发布的微博信息列表
返回用户的发布的最近n条信息，和用户微博页面返回内容是一致的。此接口也可以请求其他用户的最新发表微博。
对应API：statuses/user_timeline
| string | $screen_name | 微博昵称，主要是用来区分用户UID跟微博昵称，当二者一样而产生歧义的时候，建议使用该参数 |
| integer | $page | 页码 |
| integer | $count | 每次返回的最大记录数，最多返回200条，默认50。 |
| integer | $since_id | 若指定此参数，则只返回ID比since_id大的微博消息（即比since_id发表时间晚的微博消息）。可选。 |
| integer | $max_id | 若指定此参数，则返回ID小于或等于max_id的提到当前登录用户微博消息。可选。 |
| integer | $feature | 过滤类型ID，0：全部、1：原创、2：图片、3：视频、4：音乐，默认为0。 |
| integer | $trim_user | 返回值中user信息开关，0：返回完整的user信息、1：user字段仅返回uid，默认为0。 |
| integer | $base_app | 是否基于当前应用来获取数据。1为限制本应用微博，0为不做限制。默认为0。 |
timeline_batch_by_name(string $screen_name, integer $page = 1, integer $count = 50, integer $feature, integer $base_app) : array
批量获取指定的一批用户的timeline
对应API：statuses/timeline_batch
| string | $screen_name | 需要查询的用户昵称，用半角逗号分隔，一次最多20个 |
| integer | $page | 返回结果的页码，默认为1。 |
| integer | $count | 单页返回的记录条数，默认为50。 |
| integer | $feature | 过滤类型ID，0：全部、1：原创、2：图片、3：视频、4：音乐，默认为0。 |
| integer | $base_app | 是否只获取当前应用的数据。0为否（所有数据），1为是（仅当前应用），默认为0。 |
timeline_batch_by_id(string $uids, integer $page = 1, integer $count = 50, integer $feature, integer $base_app) : array
批量获取指定的一批用户的timeline
对应API：statuses/timeline_batch
| string | $uids | 需要查询的用户ID，用半角逗号分隔，一次最多20个。 |
| integer | $page | 返回结果的页码，默认为1。 |
| integer | $count | 单页返回的记录条数，默认为50。 |
| integer | $feature | 过滤类型ID，0：全部、1：原创、2：图片、3：视频、4：音乐，默认为0。 |
| integer | $base_app | 是否只获取当前应用的数据。0为否（所有数据），1为是（仅当前应用），默认为0。 |
repost_timeline(integer $sid, integer $page = 1, integer $count = 50, integer $since_id, integer $max_id, integer $filter_by_author) : array
返回一条原创微博消息的最新n条转发微博消息。本接口无法对非原创微博进行查询。
对应API：statuses/repost_timeline
| integer | $sid | 要获取转发微博列表的原创微博ID。 |
| integer | $page | 返回结果的页码。 |
| integer | $count | 单页返回的最大记录数，最多返回200条，默认50。可选。 |
| integer | $since_id | 若指定此参数，则只返回ID比since_id大的记录（比since_id发表时间晚）。可选。 |
| integer | $max_id | 若指定此参数，则返回ID小于或等于max_id的记录。可选。 |
| integer | $filter_by_author | 作者筛选类型，0：全部、1：我关注的人、2：陌生人，默认为0。 |
repost_by_me(integer $page = 1, integer $count = 50, integer $since_id, integer $max_id) : array
获取当前用户最新转发的n条微博消息
对应API：statuses/repost_by_me
| integer | $page | 返回结果的页码。 |
| integer | $count | 每次返回的最大记录数，最多返回200条，默认50。可选。 |
| integer | $since_id | 若指定此参数，则只返回ID比since_id大的记录（比since_id发表时间晚）。可选。 |
| integer | $max_id | 若指定此参数，则返回ID小于或等于max_id的记录。可选。 |
mentions(integer $page = 1, integer $count = 50, integer $since_id, integer $max_id, integer $filter_by_author, integer $filter_by_source, integer $filter_by_type) : array
获取@当前用户的微博列表
返回最新n条提到登录用户的微博消息（即包含@username的微博消息）
对应API：statuses/mentions
| integer | $page | 返回结果的页序号。 |
| integer | $count | 每次返回的最大记录数（即页面大小），不大于200，默认为50。 |
| integer | $since_id | 若指定此参数，则只返回ID比since_id大的微博消息（即比since_id发表时间晚的微博消息）。可选。 |
| integer | $max_id | 若指定此参数，则返回ID小于或等于max_id的提到当前登录用户微博消息。可选。 |
| integer | $filter_by_author | 作者筛选类型，0：全部、1：我关注的人、2：陌生人，默认为0。 |
| integer | $filter_by_source | 来源筛选类型，0：全部、1：来自微博、2：来自微群，默认为0。 |
| integer | $filter_by_type | 原创筛选类型，0：全部微博、1：原创的微博，默认为0。 |
show_status(integer $id) : array
根据ID获取单条微博信息内容
获取单条ID的微博信息，作者信息将同时返回。
对应API：statuses/show
| integer | $id | 要获取已发表的微博ID, 如ID不存在返回空 |
show_batch(string $ids) : array
根据微博id号获取微博的信息
对应API：statuses/show_batch
| string | $ids | 需要查询的微博ID，用半角逗号分隔，最多不超过50个。 |
querymid(integer|string $id, integer $type = 1, integer $is_batch) : array
通过微博（评论、私信）ID获取其MID
对应API：statuses/querymid
| integer|string | $id | 需要查询的微博（评论、私信）ID，批量模式下，用半角逗号分隔，最多不超过20个。 |
| integer | $type | 获取类型，1：微博、2：评论、3：私信，默认为1。 |
| integer | $is_batch | 是否使用批量模式，0：否、1：是，默认为0。 |
queryid(integer|string $mid, integer $type = 1, integer $is_batch, integer $inbox, integer $isBase62) : array
通过微博（评论、私信）MID获取其ID
对应API：statuses/queryid
| integer|string | $mid | 需要查询的微博（评论、私信）MID，批量模式下，用半角逗号分隔，最多不超过20个。 |
| integer | $type | 获取类型，1：微博、2：评论、3：私信，默认为1。 |
| integer | $is_batch | 是否使用批量模式，0：否、1：是，默认为0。 |
| integer | $inbox | 仅对私信有效，当MID类型为私信时用此参数，0：发件箱、1：收件箱，默认为0 。 |
| integer | $isBase62 | MID是否是base62编码，0：否、1：是，默认为0。 |
repost_daily(integer $count = 20, integer $base_app) : array
按天返回热门微博转发榜的微博列表
对应API：statuses/hot/repost_daily
| integer | $count | 返回的记录条数，最大不超过50，默认为20。 |
| integer | $base_app | 是否只获取当前应用的数据。0为否（所有数据），1为是（仅当前应用），默认为0。 |
repost_weekly(integer $count = 20, integer $base_app) : array
按周返回热门微博转发榜的微博列表
对应API：statuses/hot/repost_weekly
| integer | $count | 返回的记录条数，最大不超过50，默认为20。 |
| integer | $base_app | 是否只获取当前应用的数据。0为否（所有数据），1为是（仅当前应用），默认为0。 |
comments_daily(integer $count = 20, integer $base_app) : array
按天返回热门微博评论榜的微博列表
对应API：statuses/hot/comments_daily
| integer | $count | 返回的记录条数，最大不超过50，默认为20。 |
| integer | $base_app | 是否只获取当前应用的数据。0为否（所有数据），1为是（仅当前应用），默认为0。 |
comments_weekly(integer $count = 20, integer $base_app) : array
按周返回热门微博评论榜的微博列表
对应API：statuses/hot/comments_weekly
| integer | $count | 返回的记录条数，最大不超过50，默认为20。 |
| integer | $base_app | 是否只获取当前应用的数据。0为否（所有数据），1为是（仅当前应用），默认为0。 |
repost(integer $sid, string $text = NULL, integer $is_comment) : array
转发一条微博信息。
可加评论。为防止重复，发布的信息与最新信息一样话，将会被忽略。
对应API：statuses/repost
| integer | $sid | 转发的微博ID |
| string | $text | 添加的评论信息。可选。 |
| integer | $is_comment | 是否在转发的同时发表评论，0：否、1：评论给当前微博、2：评论给原微博、3：都评论，默认为0。 |
delete(integer $id) : array
删除一条微博
根据ID删除微博消息。注意：只能删除自己发布的信息。
对应API：statuses/destroy
| integer | $id | 要删除的微博ID |
destroy(integer $id) : array
删除一条微博
删除微博。注意：只能删除自己发布的信息。
对应API：statuses/destroy
| integer | $id | 要删除的微博ID |
update(string $status, float $lat = NULL, float $long = NULL, mixed $annotations = NULL, integer $visible) : array
发表微博
发布一条微博信息。
注意：lat和long参数需配合使用，用于标记发表微博消息时所在的地理位置，只有用户设置中geo_enabled=true时候地理位置信息才有效。
注意：为防止重复提交，当用户发布的微博消息与上次成功发布的微博消息内容一样时，将返回400错误，给出错误提示：“40025:Error: repeated weibo text!“。
对应API：statuses/update
| string | $status | 要更新的微博信息。信息内容不超过140个汉字, 为空返回400错误。 |
| float | $lat | 纬度，发表当前微博所在的地理位置，有效范围 -90.0到+90.0, +表示北纬。可选。 |
| float | $long | 经度。有效范围-180.0到+180.0, +表示东经。可选。 |
| mixed | $annotations | 可选参数。元数据，主要是为了方便第三方应用记录一些适合于自己使用的信息。每条微博可以包含一个或者多个元数据。请以json字串的形式提交，字串长度不超过512个字符，或者数组方式，要求json_encode后字串长度不超过512个字符。具体内容可以自定。例如：'[{"type2":123}, {"a":"b", "c":"d"}]'或array(array("type2"=>123), array("a"=>"b", "c"=>"d"))。 |
| integer | $visible | 微博的可见性，0：所有人能看，1：仅自己可见，2：密友可见，3：指定分组可见，默认为0 |
upload(string $status, string $pic_path, float $lat = NULL, float $long = NULL, integer $visible) : array
发表图片微博
发表图片微博消息。目前上传图片大小限制为<5M。
注意：lat和long参数需配合使用，用于标记发表微博消息时所在的地理位置，只有用户设置中geo_enabled=true时候地理位置信息才有效。
对应API：statuses/upload
| string | $status | 要更新的微博信息。信息内容不超过140个汉字, 为空返回400错误。 |
| string | $pic_path | 要发布的图片路径, 支持url。[只支持png/jpg/gif三种格式, 增加格式请修改get_image_mime方法] |
| float | $lat | 纬度，发表当前微博所在的地理位置，有效范围 -90.0到+90.0, +表示北纬。可选。 |
| float | $long | 可选参数，经度。有效范围-180.0到+180.0, +表示东经。可选。 |
| integer | $visible | 微博的可见性，0：所有人能看，1：仅自己可见，2：密友可见，3：指定分组可见，默认为0 |
upload_url_text(string $status, string $url, integer $visible, string $list_id = NULL, string $pic_id = NULL, float $lat = NULL, float $long = NULL, string $annotations = NULL) : array
指定一个图片URL地址抓取后上传并同时发布一条新微博
对应API：statuses/upload_url_text
| string | $status | 要发布的微博文本内容，内容不超过140个汉字。 |
| string | $url | 图片的URL地址，必须以http开头。 |
| integer | $visible | 微博的可见性，0：所有人能看，1：仅自己可见，2：密友可见，3：指定分组可见，默认为0 |
| string | $list_id | 微博的保护投递指定分组ID，只有当visible参数为3时生效且必选。 |
| string | $pic_id | 已经上传的图片pid，多个时使用英文半角逗号符分隔，最多不超过9个。 |
| float | $lat | 纬度，有效范围：-90.0到+90.0，+表示北纬，默认为0.0。 |
| float | $long | 经度，有效范围：-180.0到+180.0，+表示东经，默认为0.0。 |
| string | $annotations | 元数据，主要是为了方便第三方应用记录一些适合于自己使用的信息，每条微博可以包含一个或者多个元数据， 必须以json字串的形式提交，字串长度不超过512个字符，具体内容可以自定。 |
emotions(string $type = "face", string $language = "cnname") : array
获取表情列表
返回新浪微博官方所有表情、魔法表情的相关信息。包括短语、表情类型、表情分类，是否热门等。
对应API：emotions
| string | $type | 表情类别。"face":普通表情，"ani"：魔法表情，"cartoon"：动漫表情。默认为"face"。可选。 |
| string | $language | 语言类别，"cnname"简体，"twname"繁体。默认为"cnname"。可选 |
get_comments_by_sid(integer $sid, integer $page = 1, integer $count = 50, integer $since_id, integer $max_id, integer $filter_by_author) : array
根据微博ID返回某条微博的评论列表
对应API：comments/show
| integer | $sid | 需要查询的微博ID。 |
| integer | $page | 返回结果的页码，默认为1。 |
| integer | $count | 单页返回的记录条数，默认为50。 |
| integer | $since_id | 若指定此参数，则返回ID比since_id大的评论（即比since_id时间晚的评论），默认为0。 |
| integer | $max_id | 若指定此参数，则返回ID小于或等于max_id的评论，默认为0。 |
| integer | $filter_by_author | 作者筛选类型，0：全部、1：我关注的人、2：陌生人，默认为0。 |
comments_by_me(integer $page = 1, integer $count = 50, integer $since_id, integer $max_id, integer $filter_by_source) : array
获取当前登录用户所发出的评论列表
对应API：comments/by_me
| integer | $page | 返回结果的页码，默认为1。 |
| integer | $count | 单页返回的记录条数，默认为50。 |
| integer | $since_id | 若指定此参数，则返回ID比since_id大的评论（即比since_id时间晚的评论），默认为0。 |
| integer | $max_id | 若指定此参数，则返回ID小于或等于max_id的评论，默认为0。 |
| integer | $filter_by_source | 来源筛选类型，0：全部、1：来自微博的评论、2：来自微群的评论，默认为0。 |
comments_to_me(integer $page = 1, integer $count = 50, integer $since_id, integer $max_id, integer $filter_by_author, integer $filter_by_source) : array
获取当前登录用户所接收到的评论列表
对应API：comments/to_me
| integer | $page | 返回结果的页码，默认为1。 |
| integer | $count | 单页返回的记录条数，默认为50。 |
| integer | $since_id | 若指定此参数，则返回ID比since_id大的评论（即比since_id时间晚的评论），默认为0。 |
| integer | $max_id | 若指定此参数，则返回ID小于或等于max_id的评论，默认为0。 |
| integer | $filter_by_author | 作者筛选类型，0：全部、1：我关注的人、2：陌生人，默认为0。 |
| integer | $filter_by_source | 来源筛选类型，0：全部、1：来自微博的评论、2：来自微群的评论，默认为0。 |
comments_timeline(integer $page = 1, integer $count = 50, integer $since_id, integer $max_id) : array
最新评论(按时间)
返回最新n条发送及收到的评论。
对应API：comments/timeline
| integer | $page | 页码 |
| integer | $count | 每次返回的最大记录数，最多返回200条，默认50。 |
| integer | $since_id | 若指定此参数，则只返回ID比since_id大的评论（比since_id发表时间晚）。可选。 |
| integer | $max_id | 若指定此参数，则返回ID小于或等于max_id的评论。可选。 |
comments_mentions(integer $page = 1, integer $count = 50, integer $since_id, integer $max_id, integer $filter_by_author, integer $filter_by_source) : array
获取最新的提到当前登录用户的评论，即@我的评论
对应API：comments/mentions
| integer | $page | 返回结果的页码，默认为1。 |
| integer | $count | 单页返回的记录条数，默认为50。 |
| integer | $since_id | 若指定此参数，则返回ID比since_id大的评论（即比since_id时间晚的评论），默认为0。 |
| integer | $max_id | 若指定此参数，则返回ID小于或等于max_id的评论，默认为0。 |
| integer | $filter_by_author | 作者筛选类型，0：全部、1：我关注的人、2：陌生人，默认为0。 |
| integer | $filter_by_source | 来源筛选类型，0：全部、1：来自微博的评论、2：来自微群的评论，默认为0。 |
comments_show_batch(string $cids) : array
根据评论ID批量返回评论信息
对应API：comments/show_batch
| string | $cids | 需要查询的批量评论ID，用半角逗号分隔，最大50 |
send_comment(integer $id, string $comment, integer $comment_ori) : array
对一条微博进行评论
对应API：comments/create
| integer | $id | 需要评论的微博ID。 |
| string | $comment | 评论内容，内容不超过140个汉字。 |
| integer | $comment_ori | 当评论转发微博时，是否评论给原微博，0：否、1：是，默认为0。 |
comment_destroy(integer $cid) : array
删除当前用户的微博评论信息。
注意：只能删除自己发布的评论，发布微博的用户不可以删除其他人的评论。
对应API：statuses/comment_destroy
| integer | $cid | 要删除的评论id |
comment_destroy_batch(string $ids) : array
根据评论ID批量删除评论
注意：只能删除自己发布的评论，发部微博的用户不可以删除其他人的评论。
对应API：comments/destroy_batch
| string | $ids | 需要删除的评论ID，用半角逗号隔开，最多20个。 |
reply(integer $sid, string $text, integer $cid, integer $without_mention, integer $comment_ori) : array
回复一条评论
为防止重复，发布的信息与最后一条评论/回复信息一样话，将会被忽略。
对应API：comments/reply
| integer | $sid | 微博id |
| string | $text | 评论内容。 |
| integer | $cid | 评论id |
| integer | $without_mention | 1：回复中不自动加入“回复@用户名”，0：回复中自动加入“回复@用户名”.默认为0. |
| integer | $comment_ori | 当评论转发微博时，是否评论给原微博，0：否、1：是，默认为0。 |
show_user_by_id(integer $uid) : array
根据用户UID或昵称获取用户资料
按用户UID或昵称返回用户资料，同时也将返回用户的最新发布的微博。
对应API：users/show
| integer | $uid | 用户UID。 |
show_user_by_name(string $screen_name) : array
根据用户UID或昵称获取用户资料
按用户UID或昵称返回用户资料，同时也将返回用户的最新发布的微博。
对应API：users/show
| string | $screen_name | 用户UID。 |
domain_show(mixed $domain) : array
通过个性化域名获取用户资料以及用户最新的一条微博
对应API：users/domain_show
| mixed | $domain | 用户个性域名。例如：lazypeople，而不是http://weibo.com/lazypeople |
users_show_batch_by_id(string $uids) : array
批量获取用户信息按uids
对应API：users/show_batch
| string | $uids | 需要查询的用户ID，用半角逗号分隔，一次最多20个。 |
users_show_batch_by_name(string $screen_name) : array
批量获取用户信息按screen_name
对应API：users/show_batch
| string | $screen_name | 需要查询的用户昵称，用半角逗号分隔，一次最多20个。 |
friends_by_id(integer $uid, integer $cursor, integer $count = 50) : array
获取用户的关注列表
如果没有提供cursor参数，将只返回最前面的5000个关注id
对应API：friendships/friends
| integer | $uid | 要获取的用户的ID。 |
| integer | $cursor | 返回结果的游标，下一页用返回值里的next_cursor，上一页用previous_cursor，默认为0。 |
| integer | $count | 单页返回的记录条数，默认为50，最大不超过200。 |
friends_by_name(string $screen_name, integer $cursor, integer $count = 50) : array
获取用户的关注列表
如果没有提供cursor参数，将只返回最前面的5000个关注id
对应API：friendships/friends
| string | $screen_name | 要获取的用户的 screen_name |
| integer | $cursor | 返回结果的游标，下一页用返回值里的next_cursor，上一页用previous_cursor，默认为0。 |
| integer | $count | 单页返回的记录条数，默认为50，最大不超过200。 |
friends_in_common(integer $uid, integer $suid = NULL, integer $page = 1, integer $count = 50) : array
获取两个用户之间的共同关注人列表
对应API：friendships/friends/in_common
| integer | $uid | 需要获取共同关注关系的用户UID |
| integer | $suid | 需要获取共同关注关系的用户UID，默认为当前登录用户。 |
| integer | $page | 返回结果的页码，默认为1。 |
| integer | $count | 单页返回的记录条数，默认为50。 |
bilateral(integer $uid, integer $page = 1, integer $count = 50, integer $sort) : array
获取用户的双向关注列表，即互粉列表
对应API：friendships/friends/bilateral
| integer | $uid | 需要获取双向关注列表的用户UID。 |
| integer | $page | 返回结果的页码，默认为1。 |
| integer | $count | 单页返回的记录条数，默认为50。 |
| integer | $sort | 排序类型，0：按关注时间最近排序，默认为0。 |
bilateral_ids(integer $uid, integer $page = 1, integer $count = 50, integer $sort) : array
获取用户的双向关注uid列表
对应API：friendships/friends/bilateral/ids
| integer | $uid | 需要获取双向关注列表的用户UID。 |
| integer | $page | 返回结果的页码，默认为1。 |
| integer | $count | 单页返回的记录条数，默认为50。 |
| integer | $sort | 排序类型，0：按关注时间最近排序，默认为0。 |
friends_ids_by_id(integer $uid, integer $cursor, integer $count = 500) : array
获取用户的关注列表uid
如果没有提供cursor参数，将只返回最前面的5000个关注id
对应API：friendships/friends/ids
| integer | $uid | 要获取的用户 UID，默认为当前用户 |
| integer | $cursor | 返回结果的游标，下一页用返回值里的next_cursor，上一页用previous_cursor，默认为0。 |
| integer | $count | 每次返回的最大记录数（即页面大小），不大于5000, 默认返回500。 |
friends_ids_by_name(string $screen_name, integer $cursor, integer $count = 500) : array
获取用户的关注列表uid
如果没有提供cursor参数，将只返回最前面的5000个关注id
对应API：friendships/friends/ids
| string | $screen_name | 要获取的用户的 screen_name，默认为当前用户 |
| integer | $cursor | 返回结果的游标，下一页用返回值里的next_cursor，上一页用previous_cursor，默认为0。 |
| integer | $count | 每次返回的最大记录数（即页面大小），不大于5000, 默认返回500。 |
friends_remark_batch(string $uids) : array
批量获取当前登录用户的关注人的备注信息
对应API：friendships/friends/remark_batch
| string | $uids | 需要获取备注的用户UID，用半角逗号分隔，最多不超过50个。 |
followers_by_id(integer $uid, integer $cursor, integer $count = 50) : array
获取用户的粉丝列表
对应API：friendships/followers
| integer | $uid | 需要查询的用户UID |
| integer | $cursor | false 返回结果的游标，下一页用返回值里的next_cursor，上一页用previous_cursor，默认为0。 |
| integer | $count | 单页返回的记录条数，默认为50，最大不超过200。 |
followers_by_name(string $screen_name, integer $cursor, integer $count = 50) : array
获取用户的粉丝列表
对应API：friendships/followers
| string | $screen_name | 需要查询的用户的昵称 |
| integer | $cursor | false 返回结果的游标，下一页用返回值里的next_cursor，上一页用previous_cursor，默认为0。 |
| integer | $count | 单页返回的记录条数，默认为50，最大不超过200。 |
followers_ids_by_id(integer $uid, integer $cursor, integer $count = 50) : array
获取用户的粉丝列表uid
对应API：friendships/followers
| integer | $uid | 需要查询的用户UID |
| integer | $cursor | 返回结果的游标，下一页用返回值里的next_cursor，上一页用previous_cursor，默认为0。 |
| integer | $count | 单页返回的记录条数，默认为50，最大不超过200。 |
followers_ids_by_name(string $screen_name, integer $cursor, integer $count = 50) : array
获取用户的粉丝列表uid
对应API：friendships/followers
| string | $screen_name | 需要查询的用户screen_name |
| integer | $cursor | 返回结果的游标，下一页用返回值里的next_cursor，上一页用previous_cursor，默认为0。 |
| integer | $count | 单页返回的记录条数，默认为50，最大不超过200。 |
followers_active(integer $uid, integer $count = 20) : array
获取优质粉丝
对应API：friendships/followers/active
| integer | $uid | 需要查询的用户UID。 |
| integer | $count | 返回的记录条数，默认为20，最大不超过200。 |
friends_chain_followers(integer $uid, integer $page = 1, integer $count = 50) : array
获取当前登录用户的关注人中又关注了指定用户的用户列表
对应API：friendships/friends_chain/followers
| integer | $uid | 指定的关注目标用户UID。 |
| integer | $page | 返回结果的页码，默认为1。 |
| integer | $count | 单页返回的记录条数，默认为50。 |
is_followed_by_id(mixed $target_id, mixed $source_id = NULL) : array
返回两个用户关系的详细情况
如果源用户或目的用户不存在，将返回http的400错误
对应API：friendships/show
| mixed | $target_id | 目标用户UID |
| mixed | $source_id | 源用户UID，可选，默认为当前的用户 |
is_followed_by_name(mixed $target_name, mixed $source_name = NULL) : array
返回两个用户关系的详细情况
如果源用户或目的用户不存在，将返回http的400错误
对应API：friendships/show
| mixed | $target_name | 目标用户的微博昵称 |
| mixed | $source_name | 源用户的微博昵称，可选，默认为当前的用户 |
follow_by_id(integer $uid) : array
关注一个用户。
成功则返回关注人的资料，目前最多关注2000人，失败则返回一条字符串的说明。如果已经关注了此人，则返回http 403的状态。关注不存在的ID将返回400。
对应API：friendships/create
| integer | $uid | 要关注的用户UID |
follow_by_name(string $screen_name) : array
关注一个用户。
成功则返回关注人的资料，目前的最多关注2000人，失败则返回一条字符串的说明。如果已经关注了此人，则返回http 403的状态。关注不存在的ID将返回400。
对应API：friendships/create
| string | $screen_name | 要关注的用户昵称 |
follow_create_batch(string $uids) : array
根据用户UID批量关注用户
对应API：friendships/create_batch
| string | $uids | 要关注的用户UID，用半角逗号分隔，最多不超过20个。 |
unfollow_by_id(integer $uid) : array
取消关注某用户
取消关注某用户。成功则返回被取消关注人的资料，失败则返回一条字符串的说明。
对应API：friendships/destroy
| integer | $uid | 要取消关注的用户UID |
unfollow_by_name(string $screen_name) : array
取消关注某用户
取消关注某用户。成功则返回被取消关注人的资料，失败则返回一条字符串的说明。
对应API：friendships/destroy
| string | $screen_name | 要取消关注的用户昵称 |
update_remark(integer $uid, string $remark) : array
更新当前登录用户所关注的某个好友的备注信息
只能修改当前登录用户所关注的用户的备注信息。否则将给出400错误。
对应API：friendships/remark/update
| integer | $uid | 需要修改备注信息的用户ID。 |
| string | $remark | 备注信息。 |
list_dm(integer $page = 1, integer $count = 50, \int64 $since_id, \int64 $max_id) : array
获取当前用户最新私信列表
返回用户的最新n条私信，并包含发送者和接受者的详细资料。
对应API：direct_messages
| integer | $page | 页码 |
| integer | $count | 每次返回的最大记录数，最多返回200条，默认50。 |
| \int64 | $since_id | 返回ID比数值since_id大（比since_id时间晚的）的私信。可选。 |
| \int64 | $max_id | 返回ID不大于max_id(时间不晚于max_id)的私信。可选。 |
list_dm_sent(integer $page = 1, integer $count = 50, \int64 $since_id, \int64 $max_id) : array
获取当前用户发送的最新私信列表
返回登录用户已发送最新50条私信。包括发送者和接受者的详细资料。
对应API：direct_messages/sent
| integer | $page | 页码 |
| integer | $count | 每次返回的最大记录数，最多返回200条，默认50。 |
| \int64 | $since_id | 返回ID比数值since_id大（比since_id时间晚的）的私信。可选。 |
| \int64 | $max_id | 返回ID不大于max_id(时间不晚于max_id)的私信。可选。 |
dm_user_list(integer $count = 20, integer $cursor) : array
获取与当前登录用户有私信往来的用户列表，与该用户往来的最新私信
对应API：direct_messages/user_list
| integer | $count | 单页返回的记录条数，默认为20。 |
| integer | $cursor | 返回结果的游标，下一页用返回值里的next_cursor，上一页用previous_cursor，默认为0。 |
dm_conversation(integer $uid, integer $page = 1, integer $count = 50, integer $since_id, integer $max_id) : array
获取与指定用户的往来私信列表
对应API：direct_messages/conversation
| integer | $uid | 需要查询的用户的UID。 |
| integer | $page | 返回结果的页码，默认为1。 |
| integer | $count | 单页返回的记录条数，默认为50。 |
| integer | $since_id | 若指定此参数，则返回ID比since_id大的私信（即比since_id时间晚的私信），默认为0。 |
| integer | $max_id | 若指定此参数，则返回ID小于或等于max_id的私信，默认为0。 |
dm_show_batch(string $dmids) : array
根据私信ID批量获取私信内容
对应API：direct_messages/show_batch
| string | $dmids | 需要查询的私信ID，用半角逗号分隔，一次最多50个 |
send_dm_by_id(integer $uid, string $text, integer $id = NULL) : array
发送私信
发送一条私信。成功将返回完整的发送消息。
对应API：direct_messages/new
| integer | $uid | 用户UID |
| string | $text | 要发生的消息内容，文本大小必须小于300个汉字。 |
| integer | $id | 需要发送的微博ID。 |
send_dm_by_name(string $screen_name, string $text, integer $id = NULL) : array
发送私信
发送一条私信。成功将返回完整的发送消息。
对应API：direct_messages/new
| string | $screen_name | 用户昵称 |
| string | $text | 要发生的消息内容，文本大小必须小于300个汉字。 |
| integer | $id | 需要发送的微博ID。 |
delete_dm(integer $did) : array
删除一条私信
按ID删除私信。操作用户必须为私信的接收人。
对应API：direct_messages/destroy
| integer | $did | 要删除的私信主键ID |
delete_dms(mixed $dids) : array
批量删除私信
批量删除当前登录用户的私信。出现异常时，返回400错误。
对应API：direct_messages/destroy_batch
| mixed | $dids | 欲删除的一组私信ID，用半角逗号隔开，或者由一组评论ID组成的数组。最多20个。例如："4976494627, 4976262053"或array(4976494627,4976262053); |
account_profile_basic(integer $uid = NULL) : array
获取用户基本信息
对应API：account/profile/basic
| integer | $uid | 需要获取基本信息的用户UID，默认为当前登录用户。 |
account_education(integer $uid = NULL) : array
获取用户的教育信息
对应API：account/profile/education
| integer | $uid | 需要获取教育信息的用户UID，默认为当前登录用户。 |
account_education_batch(string $uids) : array
批量获取用户的教育信息
对应API：account/profile/education_batch
| string | $uids | 需要获取教育信息的用户UID，用半角逗号分隔，最多不超过20。 |
account_career(integer $uid = NULL) : array
获取用户的职业信息
对应API：account/profile/career
| integer | $uid | 需要获取教育信息的用户UID，默认为当前登录用户。 |
account_career_batch(string $uids) : array
批量获取用户的职业信息
对应API：account/profile/career_batch
| string | $uids | 需要获取教育信息的用户UID，用半角逗号分隔，最多不超过20。 |
get_privacy() : array
获取隐私信息设置情况
对应API：account/get_privacy
school_list(array $query) : array
获取所有的学校列表
对应API：account/profile/school_list
| array | $query | 搜索选项。格式：array('key0'=>'value0', 'key1'=>'value1', ....)。支持的key:
|
rate_limit_status() : array
获取当前登录用户的API访问频率限制情况
对应API：account/rate_limit_status
get_uid() : array
OAuth授权之后，获取授权用户的UID
对应API：account/get_uid
update_profile(array $profile) : array
更改用户资料
对应API：account/profile/basic_update
| array | $profile | 要修改的资料。格式：array('key1'=>'value1', 'key2'=>'value2', .....)。 支持修改的项：
|
edu_update(array $edu_update) : array
设置教育信息
对应API：account/profile/edu_update
| array | $edu_update | 要修改的学校信息。格式：array('key1'=>'value1', 'key2'=>'value2', .....)。 支持设置的项：
|
edu_destroy(integer $id) : array
根据学校ID删除用户的教育信息
对应API：account/profile/edu_destroy
| integer | $id | 教育信息里的学校ID。 |
car_update(array $car_update) : array
设置职业信息
对应API：account/profile/car_update
| array | $car_update | 要修改的职业信息。格式：array('key1'=>'value1', 'key2'=>'value2', .....)。 支持设置的项：
|
car_destroy(integer $id) : array
根据公司ID删除用户的职业信息
对应API：account/profile/car_destroy
| integer | $id | 职业信息里的公司ID |
update_profile_image(string $image_path) : array
更改头像
对应API：account/avatar/upload
| string | $image_path | 要上传的头像路径, 支持url。[只支持png/jpg/gif三种格式, 增加格式请修改get_image_mime方法] 必须为小于700K的有效的GIF, JPG图片. 如果图片大于500像素将按比例缩放。 |
update_privacy(array $privacy_settings) : array
设置隐私信息
对应API：account/update_privacy
| array | $privacy_settings | 要修改的隐私设置。格式：array('key1'=>'value1', 'key2'=>'value2', .....)。 支持设置的项：
|
get_favorites(integer $page = 1, integer $count = 50) : array
获取当前用户的收藏列表
返回用户的发布的最近20条收藏信息，和用户收藏页面返回内容是一致的。
对应API：favorites
| integer | $page | 返回结果的页码，默认为1。 |
| integer | $count | 单页返回的记录条数，默认为50。 |
favorites_show(integer $id) : array
根据收藏ID获取指定的收藏信息
根据收藏ID获取指定的收藏信息。
对应API：favorites/show
| integer | $id | 需要查询的收藏ID。 |
favorites_by_tags(integer $tid, integer $page = 1, integer $count = 50) : array
根据标签获取当前登录用户该标签下的收藏列表
对应API：favorites/by_tags
| integer | $tid | 需要查询的标签ID。' |
| integer | $page | 返回结果的页码，默认为1。 |
| integer | $count | 单页返回的记录条数，默认为50。 |
favorites_tags(integer $page = 1, integer $count = 50) : array
获取当前登录用户的收藏标签列表
对应API：favorites/tags
| integer | $page | 返回结果的页码，默认为1。 |
| integer | $count | 单页返回的记录条数，默认为50。 |
add_to_favorites(integer $sid) : array
收藏一条微博信息
对应API：favorites/create
| integer | $sid | 收藏的微博id |
remove_from_favorites(integer $id) : array
删除微博收藏。
对应API：favorites/destroy
| integer | $id | 要删除的收藏微博信息ID. |
remove_from_favorites_batch(mixed $fids) : array
批量删除微博收藏。
批量删除当前登录用户的收藏。出现异常时，返回HTTP400错误。
对应API：favorites/destroy_batch
| mixed | $fids | 欲删除的一组私信ID，用半角逗号隔开，或者由一组评论ID组成的数组。最多20个。例如："231101027525486630,201100826122315375"或array(231101027525486630,201100826122315375); |
favorites_tags_update(integer $id, string $tags) : array
更新一条收藏的收藏标签
对应API：favorites/tags/update
| integer | $id | 需要更新的收藏ID。 |
| string | $tags | 需要更新的标签内容，用半角逗号分隔，最多不超过2条。 |
favorites_update_batch(integer $tid, string $tag) : array
更新当前登录用户所有收藏下的指定标签
对应API：favorites/tags/update_batch
| integer | $tid | 需要更新的标签ID。必填 |
| string | $tag | 需要更新的标签内容。必填 |
favorites_tags_destroy_batch(integer $tid) : array
删除当前登录用户所有收藏下的指定标签
删除标签后，该用户所有收藏中，添加了该标签的收藏均解除与该标签的关联关系
对应API：favorites/tags/destroy_batch
| integer | $tid | 需要更新的标签ID。必填 |
get_trends(integer $uid = NULL, integer $page = 1, integer $count = 10) : array
获取某用户的话题
对应API：trends
| integer | $uid | 查询用户的ID。默认为当前用户。可选。 |
| integer | $page | 指定返回结果的页码。可选。 |
| integer | $count | 单页大小。缺省值10。可选。 |
trends_is_follow(string $trend_name) : array
判断当前用户是否关注某话题
对应API：trends/is_follow
| string | $trend_name | 话题关键字。 |
hourly_trends(integer $base_app) : array
返回最近一小时内的热门话题
对应API：trends/hourly
| integer | $base_app | 是否基于当前应用来获取数据。1表示基于当前应用来获取数据，默认为0。可选。 |
daily_trends(integer $base_app) : array
返回最近一天内的热门话题
对应API：trends/daily
| integer | $base_app | 是否基于当前应用来获取数据。1表示基于当前应用来获取数据，默认为0。可选。 |
weekly_trends(integer $base_app) : array
返回最近一周内的热门话题
对应API：trends/weekly
| integer | $base_app | 是否基于当前应用来获取数据。1表示基于当前应用来获取数据，默认为0。可选。 |
follow_trends(string $trend_name) : array
关注某话题
对应API：trends/follow
| string | $trend_name | 要关注的话题关键词。 |
unfollow_trends(integer $tid) : array
取消对某话题的关注
对应API：trends/destroy
| integer | $tid | 要取消关注的话题ID。 |
get_tags(integer $uid = NULL, integer $page = 1, integer $count = 20) : array
返回指定用户的标签列表
对应API：tags
| integer | $uid | 查询用户的ID。默认为当前用户。可选。 |
| integer | $page | 指定返回结果的页码。可选。 |
| integer | $count | 单页大小。缺省值20，最大值200。可选。 |
get_tags_batch(string $uids) : array
批量获取用户的标签列表
对应API：tags/tags_batch
| string | $uids | 要获取标签的用户ID。最大20，逗号分隔。必填 |
get_suggest_tags(integer $count = 10) : array
返回用户感兴趣的标签
对应API：tags/suggestions
| integer | $count | 单页大小。缺省值10，最大值10。可选。 |
add_tags(mixed $tags) : array
为当前登录用户添加新的用户标签
对应API：tags/create
| mixed | $tags | 要创建的一组标签，每个标签的长度不可超过7个汉字，14个半角字符。多个标签之间用逗号间隔，或由多个标签构成的数组。如："abc,drf,efgh,tt"或array("abc", "drf", "efgh", "tt") |
delete_tag(integer $tag_id) : array
删除标签
对应API：tags/destroy
| integer | $tag_id | 标签ID，必填参数 |
delete_tags(mixed $ids) : array
批量删除标签
对应API：tags/destroy_batch
| mixed | $ids | 必选参数，要删除的tag id，多个id用半角逗号分割，最多10个。或由多个tag id构成的数组。如：“553,554,555"或array(553, 554, 555) |
verify_nickname(string $nickname) : array
验证昵称是否可用，并给予建议昵称
对应API：register/verify_nickname
| string | $nickname | 需要验证的昵称。4-20个字符，支持中英文、数字、"_"或减号。必填 |
search_users(string $q, integer $count = 10) : array
搜索用户时的联想搜索建议
对应API：search/suggestions/users
| string | $q | 搜索的关键字，必须做URLencoding。必填,中间最好不要出现空格 |
| integer | $count | 返回的记录条数，默认为10。 |
search_statuses(string $q, integer $count = 10) : array
搜索微博时的联想搜索建议
对应API：search/suggestions/statuses
| string | $q | 搜索的关键字，必须做URLencoding。必填 |
| integer | $count | 返回的记录条数，默认为10。 |
search_schools(string $q, integer $count = 10, $type = 1) : array
搜索学校时的联想搜索建议
对应API：search/suggestions/schools
| string | $q | 搜索的关键字，必须做URLencoding。必填 |
| integer | $count | 返回的记录条数，默认为10。 |
| $type |
search_companies(string $q, integer $count = 10) : array
搜索公司时的联想搜索建议
对应API：search/suggestions/companies
| string | $q | 搜索的关键字，必须做URLencoding。必填 |
| integer | $count | 返回的记录条数，默认为10。 |
search_at_users(string $q, integer $count = 10, integer $type, integer $range = 2) : array
＠用户时的联想建议
对应API：search/suggestions/at_users
| string | $q | 搜索的关键字，必须做URLencoding。必填 |
| integer | $count | 返回的记录条数，默认为10。 |
| integer | $type | 联想类型，0：关注、1：粉丝。必填 |
| integer | $range | 联想范围，0：只联想关注人、1：只联想关注人的备注、2：全部，默认为2。选填 |
search_statuses_high(array $query) : array
搜索与指定的一个或多个条件相匹配的微博
对应API：search/statuses
| array | $query | 搜索选项。格式：array('key0'=>'value0', 'key1'=>'value1', ....)。支持的key:
|
search_users_keywords(array $query) : array
通过关键词搜索用户
对应API：search/users
| array | $query | 搜索选项。格式：array('key0'=>'value0', 'key1'=>'value1', ....)。支持的key:
|
hot_users(string $category = "default") : array
获取系统推荐用户
返回系统推荐的用户列表。
对应API：suggestions/users/hot
| string | $category | 分类，可选参数，返回某一类别的推荐用户，默认为 default。如果不在以下分类中，返回空列表：
|
suggestions_users_by_status(string $content, integer $num = 10) : array
根据一段微博正文推荐相关微博用户。
对应API：suggestions/users/by_status
| string | $content | 微博正文内容。 |
| integer | $num | 返回结果数目，默认为10。 |
hot_favorites(integer $page = 1, integer $count = 20) : array
热门收藏
对应API：suggestions/favorites/hot
| integer | $page | 返回页码，默认1。选填 |
| integer | $count | 每页返回结果数，默认20。选填 |
put_users_not_interested(integer $uid) : array
把某人标识为不感兴趣的人
对应API：suggestions/users/not_interested
| integer | $uid | 不感兴趣的用户的UID。 |