oauth = new Weibo($access_token, $refresh_token); } /** * 开启调试信息 * * 开启调试信息后,SDK会将每次请求微博API所发送的POST Data、Headers以及请求信息、返回内容输出出来。 * * @access public * @param bool $enable 是否开启调试信息 * @return void */ function set_debug($enable) { $this->oauth->debug = $enable; } /** * 设置用户IP * * SDK默认将会通过$_SERVER['REMOTE_ADDR']获取用户IP,在请求微博API时将用户IP附加到Request Header中。但某些情况下$_SERVER['REMOTE_ADDR']取到的IP并非用户IP,而是一个固定的IP(例如使用SAE的Cron或TaskQueue服务时),此时就有可能会造成该固定IP达到微博API调用频率限额,导致API调用失败。此时可使用本方法设置用户IP,以避免此问题。 * * @access public * @param string $ip 用户IP * @return bool IP为非法IP字符串时,返回false,否则返回true */ function set_remote_ip($ip) { if (ip2long($ip) !== false) { $this->oauth->remote_ip = $ip; return true; } else { return false; } } /** * 获取最新的公共微博消息 * * 对应API:{@link http://open.weibo.com/wiki/2/statuses/public_timeline statuses/public_timeline} * * @access public * @param int $count 单页返回的记录条数,默认为50。 * @param int $page 返回结果的页码,默认为1。 * @param int $base_app 是否只获取当前应用的数据。0为否(所有数据),1为是(仅当前应用),默认为0。 * @return array */ function public_timeline($page = 1, $count = 50, $base_app = 0) { $params = array(); $params['count'] = intval($count); $params['page'] = intval($page); $params['base_app'] = intval($base_app); return $this->oauth->get('statuses/public_timeline', $params); //可能是接口的bug不能补全 } /** * 获取当前登录用户及其所关注用户的最新微博消息。 * * 获取当前登录用户及其所关注用户的最新微博消息。和用户登录 http://weibo.com 后在“我的首页”中看到的内容相同。同friends_timeline() *
对应API:{@link http://open.weibo.com/wiki/2/statuses/home_timeline statuses/home_timeline} * * @access public * @param int $page 指定返回结果的页码。根据当前登录用户所关注的用户数及这些被关注用户发表的微博数,翻页功能最多能查看的总记录数会有所不同,通常最多能查看1000条左右。默认值1。可选。 * @param int $count 每次返回的记录数。缺省值50,最大值200。可选。 * @param int $since_id 若指定此参数,则只返回ID比since_id大的微博消息(即比since_id发表时间晚的微博消息)。可选。 * @param int $max_id 若指定此参数,则返回ID小于或等于max_id的微博消息。可选。 * @param int $base_app 是否只获取当前应用的数据。0为否(所有数据),1为是(仅当前应用),默认为0。 * @param int $feature 过滤类型ID,0:全部、1:原创、2:图片、3:视频、4:音乐,默认为0。 * @return array */ function home_timeline($page = 1, $count = 50, $since_id = 0, $max_id = 0, $base_app = 0, $feature = 0) { $params = array(); if ($since_id) { $this->id_format($since_id); $params['since_id'] = $since_id; } if ($max_id) { $this->id_format($max_id); $params['max_id'] = $max_id; } $params['count'] = intval($count); $params['page'] = intval($page); $params['base_app'] = intval($base_app); $params['feature'] = intval($feature); return $this->oauth->get('statuses/home_timeline', $params); } /** * 获取当前登录用户及其所关注用户的最新微博消息。 * * 获取当前登录用户及其所关注用户的最新微博消息。和用户登录 http://weibo.com 后在“我的首页”中看到的内容相同。同home_timeline() *
对应API:{@link http://open.weibo.com/wiki/2/statuses/friends_timeline statuses/friends_timeline} * * @access public * @param int $page 指定返回结果的页码。根据当前登录用户所关注的用户数及这些被关注用户发表的微博数,翻页功能最多能查看的总记录数会有所不同,通常最多能查看1000条左右。默认值1。可选。 * @param int $count 每次返回的记录数。缺省值50,最大值200。可选。 * @param int $since_id 若指定此参数,则只返回ID比since_id大的微博消息(即比since_id发表时间晚的微博消息)。可选。 * @param int $max_id 若指定此参数,则返回ID小于或等于max_id的微博消息。可选。 * @param int $base_app 是否基于当前应用来获取数据。1为限制本应用微博,0为不做限制。默认为0。可选。 * @param int $feature 微博类型,0全部,1原创,2图片,3视频,4音乐. 返回指定类型的微博信息内容。转为为0。可选。 * @return array */ function friends_timeline($page = 1, $count = 50, $since_id = 0, $max_id = 0, $base_app = 0, $feature = 0) { return $this->home_timeline($since_id, $max_id, $count, $page, $base_app, $feature); } /** * 获取用户发布的微博信息列表 * * 返回用户的发布的最近n条信息,和用户微博页面返回内容是一致的。此接口也可以请求其他用户的最新发表微博。 *
对应API:{@link http://open.weibo.com/wiki/2/statuses/user_timeline statuses/user_timeline} * * @access public * @param int $page 页码 * @param int $count 每次返回的最大记录数,最多返回200条,默认50。 * @param mixed $uid 指定用户UID或微博昵称 * @param int $since_id 若指定此参数,则只返回ID比since_id大的微博消息(即比since_id发表时间晚的微博消息)。可选。 * @param int $max_id 若指定此参数,则返回ID小于或等于max_id的提到当前登录用户微博消息。可选。 * @param int $base_app 是否基于当前应用来获取数据。1为限制本应用微博,0为不做限制。默认为0。 * @param int $feature 过滤类型ID,0:全部、1:原创、2:图片、3:视频、4:音乐,默认为0。 * @param int $trim_user 返回值中user信息开关,0:返回完整的user信息、1:user字段仅返回uid,默认为0。 * @return array */ function user_timeline_by_id($uid = NULL, $page = 1, $count = 50, $since_id = 0, $max_id = 0, $feature = 0, $trim_user = 0, $base_app = 0) { $params = array(); $params['uid'] = $uid; if ($since_id) { $this->id_format($since_id); $params['since_id'] = $since_id; } if ($max_id) { $this->id_format($max_id); $params['max_id'] = $max_id; } $params['base_app'] = intval($base_app); $params['feature'] = intval($feature); $params['count'] = intval($count); $params['page'] = intval($page); $params['trim_user'] = intval($trim_user); return $this->oauth->get('statuses/user_timeline', $params); } /** * 获取用户发布的微博信息列表 * * 返回用户的发布的最近n条信息,和用户微博页面返回内容是一致的。此接口也可以请求其他用户的最新发表微博。 *
对应API:{@link http://open.weibo.com/wiki/2/statuses/user_timeline statuses/user_timeline} * * @access public * @param string $screen_name 微博昵称,主要是用来区分用户UID跟微博昵称,当二者一样而产生歧义的时候,建议使用该参数 * @param int $page 页码 * @param int $count 每次返回的最大记录数,最多返回200条,默认50。 * @param int $since_id 若指定此参数,则只返回ID比since_id大的微博消息(即比since_id发表时间晚的微博消息)。可选。 * @param int $max_id 若指定此参数,则返回ID小于或等于max_id的提到当前登录用户微博消息。可选。 * @param int $feature 过滤类型ID,0:全部、1:原创、2:图片、3:视频、4:音乐,默认为0。 * @param int $trim_user 返回值中user信息开关,0:返回完整的user信息、1:user字段仅返回uid,默认为0。 * @param int $base_app 是否基于当前应用来获取数据。1为限制本应用微博,0为不做限制。默认为0。 * @return array */ function user_timeline_by_name($screen_name = NULL, $page = 1, $count = 50, $since_id = 0, $max_id = 0, $feature = 0, $trim_user = 0, $base_app = 0) { $params = array(); $params['screen_name'] = $screen_name; if ($since_id) { $this->id_format($since_id); $params['since_id'] = $since_id; } if ($max_id) { $this->id_format($max_id); $params['max_id'] = $max_id; } $params['base_app'] = intval($base_app); $params['feature'] = intval($feature); $params['count'] = intval($count); $params['page'] = intval($page); $params['trim_user'] = intval($trim_user); return $this->oauth->get('statuses/user_timeline', $params); } /** * 批量获取指定的一批用户的timeline * * 对应API:{@link http://open.weibo.com/wiki/2/statuses/timeline_batch statuses/timeline_batch} * * @param string $screen_name 需要查询的用户昵称,用半角逗号分隔,一次最多20个 * @param int $count 单页返回的记录条数,默认为50。 * @param int $page 返回结果的页码,默认为1。 * @param int $base_app 是否只获取当前应用的数据。0为否(所有数据),1为是(仅当前应用),默认为0。 * @param int $feature 过滤类型ID,0:全部、1:原创、2:图片、3:视频、4:音乐,默认为0。 * @return array */ function timeline_batch_by_name($screen_name, $page = 1, $count = 50, $feature = 0, $base_app = 0) { $params = array(); if (is_array($screen_name) && !empty($screen_name)) { $params['screen_name'] = join(',', $screen_name); } else { $params['screen_name'] = $screen_name; } $params['count'] = intval($count); $params['page'] = intval($page); $params['base_app'] = intval($base_app); $params['feature'] = intval($feature); return $this->oauth->get('statuses/timeline_batch', $params); } /** * 批量获取指定的一批用户的timeline * * 对应API:{@link http://open.weibo.com/wiki/2/statuses/timeline_batch statuses/timeline_batch} * * @param string $uids 需要查询的用户ID,用半角逗号分隔,一次最多20个。 * @param int $count 单页返回的记录条数,默认为50。 * @param int $page 返回结果的页码,默认为1。 * @param int $base_app 是否只获取当前应用的数据。0为否(所有数据),1为是(仅当前应用),默认为0。 * @param int $feature 过滤类型ID,0:全部、1:原创、2:图片、3:视频、4:音乐,默认为0。 * @return array */ function timeline_batch_by_id($uids, $page = 1, $count = 50, $feature = 0, $base_app = 0) { $params = array(); if (is_array($uids) && !empty($uids)) { foreach ($uids as $k => $v) { $this->id_format($uids[$k]); } $params['uids'] = join(',', $uids); } else { $params['uids'] = $uids; } $params['count'] = intval($count); $params['page'] = intval($page); $params['base_app'] = intval($base_app); $params['feature'] = intval($feature); return $this->oauth->get('statuses/timeline_batch', $params); } /** * 返回一条原创微博消息的最新n条转发微博消息。本接口无法对非原创微博进行查询。 * * 对应API:{@link http://open.weibo.com/wiki/2/statuses/repost_timeline statuses/repost_timeline} * * @access public * @param int $sid 要获取转发微博列表的原创微博ID。 * @param int $page 返回结果的页码。 * @param int $count 单页返回的最大记录数,最多返回200条,默认50。可选。 * @param int $since_id 若指定此参数,则只返回ID比since_id大的记录(比since_id发表时间晚)。可选。 * @param int $max_id 若指定此参数,则返回ID小于或等于max_id的记录。可选。 * @param int $filter_by_author 作者筛选类型,0:全部、1:我关注的人、2:陌生人,默认为0。 * @return array */ function repost_timeline($sid, $page = 1, $count = 50, $since_id = 0, $max_id = 0, $filter_by_author = 0) { $this->id_format($sid); $params = array(); $params['id'] = $sid; if ($since_id) { $this->id_format($since_id); $params['since_id'] = $since_id; } if ($max_id) { $this->id_format($max_id); $params['max_id'] = $max_id; } $params['filter_by_author'] = intval($filter_by_author); return $this->request_with_pager('statuses/repost_timeline', $page, $count, $params); } /** * 获取当前用户最新转发的n条微博消息 * * 对应API:{@link http://open.weibo.com/wiki/2/statuses/repost_by_me statuses/repost_by_me} * * @access public * @param int $page 返回结果的页码。 * @param int $count 每次返回的最大记录数,最多返回200条,默认50。可选。 * @param int $since_id 若指定此参数,则只返回ID比since_id大的记录(比since_id发表时间晚)。可选。 * @param int $max_id 若指定此参数,则返回ID小于或等于max_id的记录。可选。 * @return array */ function repost_by_me($page = 1, $count = 50, $since_id = 0, $max_id = 0) { $params = array(); if ($since_id) { $this->id_format($since_id); $params['since_id'] = $since_id; } if ($max_id) { $this->id_format($max_id); $params['max_id'] = $max_id; } return $this->request_with_pager('statuses/repost_by_me', $page, $count, $params); } /** * 获取@当前用户的微博列表 * * 返回最新n条提到登录用户的微博消息(即包含@username的微博消息) *
对应API:{@link http://open.weibo.com/wiki/2/statuses/mentions statuses/mentions} * * @access public * @param int $page 返回结果的页序号。 * @param int $count 每次返回的最大记录数(即页面大小),不大于200,默认为50。 * @param int $since_id 若指定此参数,则只返回ID比since_id大的微博消息(即比since_id发表时间晚的微博消息)。可选。 * @param int $max_id 若指定此参数,则返回ID小于或等于max_id的提到当前登录用户微博消息。可选。 * @param int $filter_by_author 作者筛选类型,0:全部、1:我关注的人、2:陌生人,默认为0。 * @param int $filter_by_source 来源筛选类型,0:全部、1:来自微博、2:来自微群,默认为0。 * @param int $filter_by_type 原创筛选类型,0:全部微博、1:原创的微博,默认为0。 * @return array */ function mentions($page = 1, $count = 50, $since_id = 0, $max_id = 0, $filter_by_author = 0, $filter_by_source = 0, $filter_by_type = 0) { $params = array(); if ($since_id) { $this->id_format($since_id); $params['since_id'] = $since_id; } if ($max_id) { $this->id_format($max_id); $params['max_id'] = $max_id; } $params['filter_by_author'] = $filter_by_author; $params['filter_by_source'] = $filter_by_source; $params['filter_by_type'] = $filter_by_type; return $this->request_with_pager('statuses/mentions', $page, $count, $params); } /** * 根据ID获取单条微博信息内容 * * 获取单条ID的微博信息,作者信息将同时返回。 *
对应API:{@link http://open.weibo.com/wiki/2/statuses/show statuses/show} * * @access public * @param int $id 要获取已发表的微博ID, 如ID不存在返回空 * @return array */ function show_status($id) { $this->id_format($id); $params = array(); $params['id'] = $id; return $this->oauth->get('statuses/show', $params); } /** * 根据微博id号获取微博的信息 * * 对应API:{@link http://open.weibo.com/wiki/2/statuses/show_batch statuses/show_batch} * * @param string $ids 需要查询的微博ID,用半角逗号分隔,最多不超过50个。 * @return array */ function show_batch($ids) { $params = array(); if (is_array($ids) && !empty($ids)) { foreach ($ids as $k => $v) { $this->id_format($ids[$k]); } $params['ids'] = join(',', $ids); } else { $params['ids'] = $ids; } return $this->oauth->get('statuses/show_batch', $params); } /** * 通过微博(评论、私信)ID获取其MID * * 对应API:{@link http://open.weibo.com/wiki/2/statuses/querymid statuses/querymid} * * @param int|string $id 需要查询的微博(评论、私信)ID,批量模式下,用半角逗号分隔,最多不超过20个。 * @param int $type 获取类型,1:微博、2:评论、3:私信,默认为1。 * @param int $is_batch 是否使用批量模式,0:否、1:是,默认为0。 * @return array */ function querymid($id, $type = 1, $is_batch = 0) { $params = array(); $params['id'] = $id; $params['type'] = intval($type); $params['is_batch'] = intval($is_batch); return $this->oauth->get('statuses/querymid', $params); } /** * 通过微博(评论、私信)MID获取其ID * * 对应API:{@link http://open.weibo.com/wiki/2/statuses/queryid statuses/queryid} * * @param int|string $mid 需要查询的微博(评论、私信)MID,批量模式下,用半角逗号分隔,最多不超过20个。 * @param int $type 获取类型,1:微博、2:评论、3:私信,默认为1。 * @param int $is_batch 是否使用批量模式,0:否、1:是,默认为0。 * @param int $inbox 仅对私信有效,当MID类型为私信时用此参数,0:发件箱、1:收件箱,默认为0 。 * @param int $isBase62 MID是否是base62编码,0:否、1:是,默认为0。 * @return array */ function queryid($mid, $type = 1, $is_batch = 0, $inbox = 0, $isBase62 = 0) { $params = array(); $params['mid'] = $mid; $params['type'] = intval($type); $params['is_batch'] = intval($is_batch); $params['inbox'] = intval($inbox); $params['isBase62'] = intval($isBase62); return $this->oauth->get('statuses/queryid', $params); } /** * 按天返回热门微博转发榜的微博列表 * * 对应API:{@link http://open.weibo.com/wiki/2/statuses/hot/repost_daily statuses/hot/repost_daily} * * @param int $count 返回的记录条数,最大不超过50,默认为20。 * @param int $base_app 是否只获取当前应用的数据。0为否(所有数据),1为是(仅当前应用),默认为0。 * @return array */ function repost_daily($count = 20, $base_app = 0) { $params = array(); $params['count'] = intval($count); $params['base_app'] = intval($base_app); return $this->oauth->get('statuses/hot/repost_daily', $params); } /** * 按周返回热门微博转发榜的微博列表 * * 对应API:{@link http://open.weibo.com/wiki/2/statuses/hot/repost_weekly statuses/hot/repost_weekly} * * @param int $count 返回的记录条数,最大不超过50,默认为20。 * @param int $base_app 是否只获取当前应用的数据。0为否(所有数据),1为是(仅当前应用),默认为0。 * @return array */ function repost_weekly($count = 20, $base_app = 0) { $params = array(); $params['count'] = intval($count); $params['base_app'] = intval($base_app); return $this->oauth->get('statuses/hot/repost_weekly', $params); } /** * 按天返回热门微博评论榜的微博列表 * * 对应API:{@link http://open.weibo.com/wiki/2/statuses/hot/comments_daily statuses/hot/comments_daily} * * @param int $count 返回的记录条数,最大不超过50,默认为20。 * @param int $base_app 是否只获取当前应用的数据。0为否(所有数据),1为是(仅当前应用),默认为0。 * @return array */ function comments_daily($count = 20, $base_app = 0) { $params = array(); $params['count'] = intval($count); $params['base_app'] = intval($base_app); return $this->oauth->get('statuses/hot/comments_daily', $params); } /** * 按周返回热门微博评论榜的微博列表 * * 对应API:{@link http://open.weibo.com/wiki/2/statuses/hot/comments_weekly statuses/hot/comments_weekly} * * @param int $count 返回的记录条数,最大不超过50,默认为20。 * @param int $base_app 是否只获取当前应用的数据。0为否(所有数据),1为是(仅当前应用),默认为0。 * @return array */ function comments_weekly($count = 20, $base_app = 0) { $params = array(); $params['count'] = intval($count); $params['base_app'] = intval($base_app); return $this->oauth->get('statuses/hot/comments_weekly', $params); } /** * 转发一条微博信息。 * * 可加评论。为防止重复,发布的信息与最新信息一样话,将会被忽略。 *
对应API:{@link http://open.weibo.com/wiki/2/statuses/repost statuses/repost} * * @access public * @param int $sid 转发的微博ID * @param string $text 添加的评论信息。可选。 * @param int $is_comment 是否在转发的同时发表评论,0:否、1:评论给当前微博、2:评论给原微博、3:都评论,默认为0。 * @return array */ function repost($sid, $text = NULL, $is_comment = 0) { $this->id_format($sid); $params = array(); $params['id'] = $sid; $params['is_comment'] = $is_comment; if ($text) $params['status'] = $text; return $this->oauth->post('statuses/repost', $params); } /** * 删除一条微博 * * 根据ID删除微博消息。注意:只能删除自己发布的信息。 *
对应API:{@link http://open.weibo.com/wiki/2/statuses/destroy statuses/destroy} * * @access public * @param int $id 要删除的微博ID * @return array */ function delete($id) { return $this->destroy($id); } /** * 删除一条微博 * * 删除微博。注意:只能删除自己发布的信息。 *
对应API:{@link http://open.weibo.com/wiki/2/statuses/destroy statuses/destroy} * * @access public * @param int $id 要删除的微博ID * @return array */ function destroy($id) { $this->id_format($id); $params = array(); $params['id'] = $id; return $this->oauth->post('statuses/destroy', $params); } /** * 发表微博 * * 发布一条微博信息。 *
注意:lat和long参数需配合使用,用于标记发表微博消息时所在的地理位置,只有用户设置中geo_enabled=true时候地理位置信息才有效。 *
注意:为防止重复提交,当用户发布的微博消息与上次成功发布的微博消息内容一样时,将返回400错误,给出错误提示:“40025:Error: repeated weibo text!“。 *
对应API:{@link http://open.weibo.com/wiki/2/statuses/update statuses/update} * * @access public * @param string $status 要更新的微博信息。信息内容不超过140个汉字, 为空返回400错误。 * @param float $lat 纬度,发表当前微博所在的地理位置,有效范围 -90.0到+90.0, +表示北纬。可选。 * @param float $long 经度。有效范围-180.0到+180.0, +表示东经。可选。 * @param mixed $annotations 可选参数。元数据,主要是为了方便第三方应用记录一些适合于自己使用的信息。每条微博可以包含一个或者多个元数据。请以json字串的形式提交,字串长度不超过512个字符,或者数组方式,要求json_encode后字串长度不超过512个字符。具体内容可以自定。例如:'[{"type2":123}, {"a":"b", "c":"d"}]'或array(array("type2"=>123), array("a"=>"b", "c"=>"d"))。 * @return array */ function update($status, $lat = NULL, $long = NULL, $annotations = NULL) { $params = array(); $params['status'] = $status; if ($lat) { $params['lat'] = floatval($lat); } if ($long) { $params['long'] = floatval($long); } if (is_string($annotations)) { $params['annotations'] = $annotations; } elseif (is_array($annotations)) { $params['annotations'] = json_encode($annotations); } return $this->oauth->post('statuses/update', $params); } /** * 发表图片微博 * * 发表图片微博消息。目前上传图片大小限制为<5M。 *
注意:lat和long参数需配合使用,用于标记发表微博消息时所在的地理位置,只有用户设置中geo_enabled=true时候地理位置信息才有效。 *
对应API:{@link http://open.weibo.com/wiki/2/statuses/upload statuses/upload} * * @access public * @param string $status 要更新的微博信息。信息内容不超过140个汉字, 为空返回400错误。 * @param string $pic_path 要发布的图片路径, 支持url。[只支持png/jpg/gif三种格式, 增加格式请修改get_image_mime方法] * @param float $lat 纬度,发表当前微博所在的地理位置,有效范围 -90.0到+90.0, +表示北纬。可选。 * @param float $long 可选参数,经度。有效范围-180.0到+180.0, +表示东经。可选。 * @return array */ function upload($status, $pic_path, $lat = NULL, $long = NULL) { $params = array(); $params['status'] = $status; $params['pic'] = '@' . $pic_path; if ($lat) { $params['lat'] = floatval($lat); } if ($long) { $params['long'] = floatval($long); } return $this->oauth->post('statuses/upload', $params, true); } /** * 指定一个图片URL地址抓取后上传并同时发布一条新微博 * * 对应API:{@link http://open.weibo.com/wiki/2/statuses/upload_url_text statuses/upload_url_text} * * @param string $status 要发布的微博文本内容,内容不超过140个汉字。 * @param string $url 图片的URL地址,必须以http开头。 * @return array */ function upload_url_text($status, $url) { $params = array(); $params['status'] = $status; $params['url'] = $url; return $this->oauth->post('statuses/upload', $params, true); } /** * 获取表情列表 * * 返回新浪微博官方所有表情、魔法表情的相关信息。包括短语、表情类型、表情分类,是否热门等。 *
对应API:{@link http://open.weibo.com/wiki/2/emotions emotions} * * @access public * @param string $type 表情类别。"face":普通表情,"ani":魔法表情,"cartoon":动漫表情。默认为"face"。可选。 * @param string $language 语言类别,"cnname"简体,"twname"繁体。默认为"cnname"。可选 * @return array */ function emotions($type = "face", $language = "cnname") { $params = array(); $params['type'] = $type; $params['language'] = $language; return $this->oauth->get('emotions', $params); } /** * 根据微博ID返回某条微博的评论列表 * * 对应API:{@link http://open.weibo.com/wiki/2/comments/show comments/show} * * @param int $sid 需要查询的微博ID。 * @param int $page 返回结果的页码,默认为1。 * @param int $count 单页返回的记录条数,默认为50。 * @param int $since_id 若指定此参数,则返回ID比since_id大的评论(即比since_id时间晚的评论),默认为0。 * @param int $max_id 若指定此参数,则返回ID小于或等于max_id的评论,默认为0。 * @param int $filter_by_author 作者筛选类型,0:全部、1:我关注的人、2:陌生人,默认为0。 * @return array */ function get_comments_by_sid($sid, $page = 1, $count = 50, $since_id = 0, $max_id = 0, $filter_by_author = 0) { $params = array(); $this->id_format($sid); $params['id'] = $sid; if ($since_id) { $this->id_format($since_id); $params['since_id'] = $since_id; } if ($max_id) { $this->id_format($max_id); $params['max_id'] = $max_id; } $params['count'] = $count; $params['page'] = $page; $params['filter_by_author'] = $filter_by_author; return $this->oauth->get('comments/show', $params); } /** * 获取当前登录用户所发出的评论列表 * * 对应API:{@link http://open.weibo.com/wiki/2/comments/by_me comments/by_me} * * @param int $since_id 若指定此参数,则返回ID比since_id大的评论(即比since_id时间晚的评论),默认为0。 * @param int $max_id 若指定此参数,则返回ID小于或等于max_id的评论,默认为0。 * @param int $count 单页返回的记录条数,默认为50。 * @param int $page 返回结果的页码,默认为1。 * @param int $filter_by_source 来源筛选类型,0:全部、1:来自微博的评论、2:来自微群的评论,默认为0。 * @return array */ function comments_by_me($page = 1, $count = 50, $since_id = 0, $max_id = 0, $filter_by_source = 0) { $params = array(); if ($since_id) { $this->id_format($since_id); $params['since_id'] = $since_id; } if ($max_id) { $this->id_format($max_id); $params['max_id'] = $max_id; } $params['count'] = $count; $params['page'] = $page; $params['filter_by_source'] = $filter_by_source; return $this->oauth->get('comments/by_me', $params); } /** * 获取当前登录用户所接收到的评论列表 * * 对应API:{@link http://open.weibo.com/wiki/2/comments/to_me comments/to_me} * * @param int $since_id 若指定此参数,则返回ID比since_id大的评论(即比since_id时间晚的评论),默认为0。 * @param int $max_id 若指定此参数,则返回ID小于或等于max_id的评论,默认为0。 * @param int $count 单页返回的记录条数,默认为50。 * @param int $page 返回结果的页码,默认为1。 * @param int $filter_by_author 作者筛选类型,0:全部、1:我关注的人、2:陌生人,默认为0。 * @param int $filter_by_source 来源筛选类型,0:全部、1:来自微博的评论、2:来自微群的评论,默认为0。 * @return array */ function comments_to_me($page = 1, $count = 50, $since_id = 0, $max_id = 0, $filter_by_author = 0, $filter_by_source = 0) { $params = array(); if ($since_id) { $this->id_format($since_id); $params['since_id'] = $since_id; } if ($max_id) { $this->id_format($max_id); $params['max_id'] = $max_id; } $params['count'] = $count; $params['page'] = $page; $params['filter_by_author'] = $filter_by_author; $params['filter_by_source'] = $filter_by_source; return $this->oauth->get('comments/to_me', $params); } /** * 最新评论(按时间) * * 返回最新n条发送及收到的评论。 *
对应API:{@link http://open.weibo.com/wiki/2/comments/timeline comments/timeline} * * @access public * @param int $page 页码 * @param int $count 每次返回的最大记录数,最多返回200条,默认50。 * @param int $since_id 若指定此参数,则只返回ID比since_id大的评论(比since_id发表时间晚)。可选。 * @param int $max_id 若指定此参数,则返回ID小于或等于max_id的评论。可选。 * @return array */ function comments_timeline($page = 1, $count = 50, $since_id = 0, $max_id = 0) { $params = array(); if ($since_id) { $this->id_format($since_id); $params['since_id'] = $since_id; } if ($max_id) { $this->id_format($max_id); $params['max_id'] = $max_id; } return $this->request_with_pager('comments/timeline', $page, $count, $params); } /** * 获取最新的提到当前登录用户的评论,即@我的评论 * * 对应API:{@link http://open.weibo.com/wiki/2/comments/mentions comments/mentions} * * @param int $since_id 若指定此参数,则返回ID比since_id大的评论(即比since_id时间晚的评论),默认为0。 * @param int $max_id 若指定此参数,则返回ID小于或等于max_id的评论,默认为0。 * @param int $count 单页返回的记录条数,默认为50。 * @param int $page 返回结果的页码,默认为1。 * @param int $filter_by_author 作者筛选类型,0:全部、1:我关注的人、2:陌生人,默认为0。 * @param int $filter_by_source 来源筛选类型,0:全部、1:来自微博的评论、2:来自微群的评论,默认为0。 * @return array */ function comments_mentions($page = 1, $count = 50, $since_id = 0, $max_id = 0, $filter_by_author = 0, $filter_by_source = 0) { $params = array(); $params['since_id'] = $since_id; $params['max_id'] = $max_id; $params['count'] = $count; $params['page'] = $page; $params['filter_by_author'] = $filter_by_author; $params['filter_by_source'] = $filter_by_source; return $this->oauth->get('comments/mentions', $params); } /** * 根据评论ID批量返回评论信息 * * 对应API:{@link http://open.weibo.com/wiki/2/comments/show_batch comments/show_batch} * * @param string $cids 需要查询的批量评论ID,用半角逗号分隔,最大50 * @return array */ function comments_show_batch($cids) { $params = array(); if (is_array($cids) && !empty($cids)) { foreach ($cids as $k => $v) { $this->id_format($cids[$k]); } $params['cids'] = join(',', $cids); } else { $params['cids'] = $cids; } return $this->oauth->get('comments/show_batch', $params); } /** * 对一条微博进行评论 * * 对应API:{@link http://open.weibo.com/wiki/2/comments/create comments/create} * * @param string $comment 评论内容,内容不超过140个汉字。 * @param int $id 需要评论的微博ID。 * @param int $comment_ori 当评论转发微博时,是否评论给原微博,0:否、1:是,默认为0。 * @return array */ function send_comment($id, $comment, $comment_ori = 0) { $params = array(); $params['comment'] = $comment; $this->id_format($id); $params['id'] = $id; $params['comment_ori'] = $comment_ori; return $this->oauth->post('comments/create', $params); } /** * 删除当前用户的微博评论信息。 * * 注意:只能删除自己发布的评论,发部微博的用户不可以删除其他人的评论。 *
对应API:{@link http://open.weibo.com/wiki/2/statuses/comment_destroy statuses/comment_destroy} * * @access public * @param int $cid 要删除的评论id * @return array */ function comment_destroy($cid) { $params = array(); $params['cid'] = $cid; return $this->oauth->post('comments/destroy', $params); } /** * 根据评论ID批量删除评论 * * 注意:只能删除自己发布的评论,发部微博的用户不可以删除其他人的评论。 *
对应API:{@link http://open.weibo.com/wiki/2/comments/destroy_batch comments/destroy_batch} * * @access public * @param string $ids 需要删除的评论ID,用半角逗号隔开,最多20个。 * @return array */ function comment_destroy_batch($ids) { $params = array(); if (is_array($ids) && !empty($ids)) { foreach ($ids as $k => $v) { $this->id_format($ids[$k]); } $params['cids'] = join(',', $ids); } else { $params['cids'] = $ids; } return $this->oauth->post('comments/destroy_batch', $params); } /** * 回复一条评论 * * 为防止重复,发布的信息与最后一条评论/回复信息一样话,将会被忽略。 *
对应API:{@link http://open.weibo.com/wiki/2/comments/reply comments/reply} * * @access public * @param int $sid 微博id * @param string $text 评论内容。 * @param int $cid 评论id * @param int $without_mention 1:回复中不自动加入“回复@用户名”,0:回复中自动加入“回复@用户名”.默认为0. * @param int $comment_ori 当评论转发微博时,是否评论给原微博,0:否、1:是,默认为0。 * @return array */ function reply($sid, $text, $cid, $without_mention = 0, $comment_ori = 0) { $this->id_format($sid); $this->id_format($cid); $params = array(); $params['id'] = $sid; $params['comment'] = $text; $params['cid'] = $cid; $params['without_mention'] = $without_mention; $params['comment_ori'] = $comment_ori; return $this->oauth->post('comments/reply', $params); } /** * 根据用户UID或昵称获取用户资料 * * 按用户UID或昵称返回用户资料,同时也将返回用户的最新发布的微博。 *
对应API:{@link http://open.weibo.com/wiki/2/users/show users/show} * * @access public * @param int $uid 用户UID。 * @return array */ function show_user_by_id($uid) { $params = array(); if ($uid !== NULL) { $this->id_format($uid); $params['uid'] = $uid; } return $this->oauth->get('users/show', $params); } /** * 根据用户UID或昵称获取用户资料 * * 按用户UID或昵称返回用户资料,同时也将返回用户的最新发布的微博。 *
对应API:{@link http://open.weibo.com/wiki/2/users/show users/show} * * @access public * @param string $screen_name 用户UID。 * @return array */ function show_user_by_name($screen_name) { $params = array(); $params['screen_name'] = $screen_name; return $this->oauth->get('users/show', $params); } /** * 通过个性化域名获取用户资料以及用户最新的一条微博 * * 对应API:{@link http://open.weibo.com/wiki/2/users/domain_show users/domain_show} * * @access public * @param mixed $domain 用户个性域名。例如:lazypeople,而不是http://weibo.com/lazypeople * @return array */ function domain_show($domain) { $params = array(); $params['domain'] = $domain; return $this->oauth->get('users/domain_show', $params); } /** * 批量获取用户信息按uids * * 对应API:{@link http://open.weibo.com/wiki/2/users/show_batch users/show_batch} * * @param string $uids 需要查询的用户ID,用半角逗号分隔,一次最多20个。 * @return array */ function users_show_batch_by_id($uids) { $params = array(); if (is_array($uids) && !empty($uids)) { foreach ($uids as $k => $v) { $this->id_format($uids[$k]); } $params['uids'] = join(',', $uids); } else { $params['uids'] = $uids; } return $this->oauth->get('users/show_batch', $params); } /** * 批量获取用户信息按screen_name * * 对应API:{@link http://open.weibo.com/wiki/2/users/show_batch users/show_batch} * * @param string $screen_name 需要查询的用户昵称,用半角逗号分隔,一次最多20个。 * @return array */ function users_show_batch_by_name($screen_name) { $params = array(); if (is_array($screen_name) && !empty($screen_name)) { $params['screen_name'] = join(',', $screen_name); } else { $params['screen_name'] = $screen_name; } return $this->oauth->get('users/show_batch', $params); } /** * 获取用户的关注列表 * * 如果没有提供cursor参数,将只返回最前面的5000个关注id *
对应API:{@link http://open.weibo.com/wiki/2/friendships/friends friendships/friends} * * @access public * @param int $cursor 返回结果的游标,下一页用返回值里的next_cursor,上一页用previous_cursor,默认为0。 * @param int $count 单页返回的记录条数,默认为50,最大不超过200。 * @param int $uid 要获取的用户的ID。 * @return array */ function friends_by_id($uid, $cursor = 0, $count = 50) { $params = array(); $params['cursor'] = $cursor; $params['count'] = $count; $params['uid'] = $uid; return $this->oauth->get('friendships/friends', $params); } /** * 获取用户的关注列表 * * 如果没有提供cursor参数,将只返回最前面的5000个关注id *
对应API:{@link http://open.weibo.com/wiki/2/friendships/friends friendships/friends} * * @access public * @param int $cursor 返回结果的游标,下一页用返回值里的next_cursor,上一页用previous_cursor,默认为0。 * @param int $count 单页返回的记录条数,默认为50,最大不超过200。 * @param string $screen_name 要获取的用户的 screen_name * @return array */ function friends_by_name($screen_name, $cursor = 0, $count = 50) { $params = array(); $params['cursor'] = $cursor; $params['count'] = $count; $params['screen_name'] = $screen_name; return $this->oauth->get('friendships/friends', $params); } /** * 获取两个用户之间的共同关注人列表 * * 对应API:{@link http://open.weibo.com/wiki/2/friendships/friends/in_common friendships/friends/in_common} * * @param int $uid 需要获取共同关注关系的用户UID * @param int $suid 需要获取共同关注关系的用户UID,默认为当前登录用户。 * @param int $count 单页返回的记录条数,默认为50。 * @param int $page 返回结果的页码,默认为1。 * @return array */ function friends_in_common($uid, $suid = NULL, $page = 1, $count = 50) { $params = array(); $params['uid'] = $uid; $params['suid'] = $suid; $params['count'] = $count; $params['page'] = $page; return $this->oauth->get('friendships/friends/in_common', $params); } /** * 获取用户的双向关注列表,即互粉列表 * * 对应API:{@link http://open.weibo.com/wiki/2/friendships/friends/bilateral friendships/friends/bilateral} * * @param int $uid 需要获取双向关注列表的用户UID。 * @param int $count 单页返回的记录条数,默认为50。 * @param int $page 返回结果的页码,默认为1。 * @param int $sort 排序类型,0:按关注时间最近排序,默认为0。 * @return array * */ function bilateral($uid, $page = 1, $count = 50, $sort = 0) { $params = array(); $params['uid'] = $uid; $params['count'] = $count; $params['page'] = $page; $params['sort'] = $sort; return $this->oauth->get('friendships/friends/bilateral', $params); } /** * 获取用户的双向关注uid列表 * * 对应API:{@link http://open.weibo.com/wiki/2/friendships/friends/bilateral/ids friendships/friends/bilateral/ids} * * @param int $uid 需要获取双向关注列表的用户UID。 * @param int $count 单页返回的记录条数,默认为50。 * @param int $page 返回结果的页码,默认为1。 * @param int $sort 排序类型,0:按关注时间最近排序,默认为0。 * @return array * */ function bilateral_ids($uid, $page = 1, $count = 50, $sort = 0) { $params = array(); $params['uid'] = $uid; $params['count'] = $count; $params['page'] = $page; $params['sort'] = $sort; return $this->oauth->get('friendships/friends/bilateral/ids', $params); } /** * 获取用户的关注列表uid * * 如果没有提供cursor参数,将只返回最前面的5000个关注id *
对应API:{@link http://open.weibo.com/wiki/2/friendships/friends/ids friendships/friends/ids} * * @access public * @param int $cursor 返回结果的游标,下一页用返回值里的next_cursor,上一页用previous_cursor,默认为0。 * @param int $count 每次返回的最大记录数(即页面大小),不大于5000, 默认返回500。 * @param int $uid 要获取的用户 UID,默认为当前用户 * @return array */ function friends_ids_by_id($uid, $cursor = 0, $count = 500) { $params = array(); $this->id_format($uid); $params['uid'] = $uid; $params['cursor'] = $cursor; $params['count'] = $count; return $this->oauth->get('friendships/friends/ids', $params); } /** * 获取用户的关注列表uid * * 如果没有提供cursor参数,将只返回最前面的5000个关注id *
对应API:{@link http://open.weibo.com/wiki/2/friendships/friends/ids friendships/friends/ids} * * @access public * @param int $cursor 返回结果的游标,下一页用返回值里的next_cursor,上一页用previous_cursor,默认为0。 * @param int $count 每次返回的最大记录数(即页面大小),不大于5000, 默认返回500。 * @param string $screen_name 要获取的用户的 screen_name,默认为当前用户 * @return array */ function friends_ids_by_name($screen_name, $cursor = 0, $count = 500) { $params = array(); $params['cursor'] = $cursor; $params['count'] = $count; $params['screen_name'] = $screen_name; return $this->oauth->get('friendships/friends/ids', $params); } /** * 批量获取当前登录用户的关注人的备注信息 * * 对应API:{@link http://open.weibo.com/wiki/2/friendships/friends/remark_batch friendships/friends/remark_batch} * * @param string $uids 需要获取备注的用户UID,用半角逗号分隔,最多不超过50个。 * @return array * */ function friends_remark_batch($uids) { $params = array(); if (is_array($uids) && !empty($uids)) { foreach ($uids as $k => $v) { $this->id_format($uids[$k]); } $params['uids'] = join(',', $uids); } else { $params['uids'] = $uids; } return $this->oauth->get('friendships/friends/remark_batch', $params); } /** * 获取用户的粉丝列表 * * 对应API:{@link http://open.weibo.com/wiki/2/friendships/followers friendships/followers} * * @param int $uid 需要查询的用户UID * @param int $count 单页返回的记录条数,默认为50,最大不超过200。 * @param int $cursor false 返回结果的游标,下一页用返回值里的next_cursor,上一页用previous_cursor,默认为0。 * @return array * */ function followers_by_id($uid, $cursor = 0, $count = 50) { $params = array(); $this->id_format($uid); $params['uid'] = $uid; $params['count'] = $count; $params['cursor'] = $cursor; return $this->oauth->get('friendships/followers', $params); } /** * 获取用户的粉丝列表 * * 对应API:{@link http://open.weibo.com/wiki/2/friendships/followers friendships/followers} * * @param string $screen_name 需要查询的用户的昵称 * @param int $count 单页返回的记录条数,默认为50,最大不超过200。 * @param int $cursor false 返回结果的游标,下一页用返回值里的next_cursor,上一页用previous_cursor,默认为0。 * @return array * */ function followers_by_name($screen_name, $cursor = 0, $count = 50) { $params = array(); $params['screen_name'] = $screen_name; $params['count'] = $count; $params['cursor'] = $cursor; return $this->oauth->get('friendships/followers', $params); } /** * 获取用户的粉丝列表uid * * 对应API:{@link http://open.weibo.com/wiki/2/friendships/followers friendships/followers} * * @param int $uid 需要查询的用户UID * @param int $count 单页返回的记录条数,默认为50,最大不超过200。 * @param int $cursor 返回结果的游标,下一页用返回值里的next_cursor,上一页用previous_cursor,默认为0。 * @return array * */ function followers_ids_by_id($uid, $cursor = 0, $count = 50) { $params = array(); $this->id_format($uid); $params['uid'] = $uid; $params['count'] = $count; $params['cursor'] = $cursor; return $this->oauth->get('friendships/followers/ids', $params); } /** * 获取用户的粉丝列表uid * * 对应API:{@link http://open.weibo.com/wiki/2/friendships/followers friendships/followers} * * @param string $screen_name 需要查询的用户screen_name * @param int $count 单页返回的记录条数,默认为50,最大不超过200。 * @param int $cursor 返回结果的游标,下一页用返回值里的next_cursor,上一页用previous_cursor,默认为0。 * @return array * */ function followers_ids_by_name($screen_name, $cursor = 0, $count = 50) { $params = array(); $params['screen_name'] = $screen_name; $params['count'] = $count; $params['cursor'] = $cursor; return $this->oauth->get('friendships/followers/ids', $params); } /** * 获取优质粉丝 * * 对应API:{@link http://open.weibo.com/wiki/2/friendships/followers/active friendships/followers/active} * * @param int $uid 需要查询的用户UID。 * @param int $count 返回的记录条数,默认为20,最大不超过200。 * @return array * */ function followers_active($uid, $count = 20) { $param = array(); $this->id_format($uid); $param['uid'] = $uid; $param['count'] = $count; return $this->oauth->get('friendships/followers/active', $param); } /** * 获取当前登录用户的关注人中又关注了指定用户的用户列表 * * 对应API:{@link http://open.weibo.com/wiki/2/friendships/friends_chain/followers friendships/friends_chain/followers} * * @param int $uid 指定的关注目标用户UID。 * @param int $count 单页返回的记录条数,默认为50。 * @param int $page 返回结果的页码,默认为1。 * @return array * */ function friends_chain_followers($uid, $page = 1, $count = 50) { $params = array(); $this->id_format($uid); $params['uid'] = $uid; $params['count'] = $count; $params['page'] = $page; return $this->oauth->get('friendships/friends_chain/followers', $params); } /** * 返回两个用户关系的详细情况 * * 如果源用户或目的用户不存在,将返回http的400错误 *
对应API:{@link http://open.weibo.com/wiki/2/friendships/show friendships/show} * * @access public * @param mixed $target_id 目标用户UID * @param mixed $source_id 源用户UID,可选,默认为当前的用户 * @return array */ function is_followed_by_id($target_id, $source_id = NULL) { $params = array(); $this->id_format($target_id); $params['target_id'] = $target_id; if ($source_id != NULL) { $this->id_format($source_id); $params['source_id'] = $source_id; } return $this->oauth->get('friendships/show', $params); } /** * 返回两个用户关系的详细情况 * * 如果源用户或目的用户不存在,将返回http的400错误 *
对应API:{@link http://open.weibo.com/wiki/2/friendships/show friendships/show} * * @access public * @param mixed $target_name 目标用户的微博昵称 * @param mixed $source_name 源用户的微博昵称,可选,默认为当前的用户 * @return array */ function is_followed_by_name($target_name, $source_name = NULL) { $params = array(); $params['target_screen_name'] = $target_name; if ($source_name != NULL) { $params['source_screen_name'] = $source_name; } return $this->oauth->get('friendships/show', $params); } /** * 关注一个用户。 * * 成功则返回关注人的资料,目前最多关注2000人,失败则返回一条字符串的说明。如果已经关注了此人,则返回http 403的状态。关注不存在的ID将返回400。 *
对应API:{@link http://open.weibo.com/wiki/2/friendships/create friendships/create} * * @access public * @param int $uid 要关注的用户UID * @return array */ function follow_by_id($uid) { $params = array(); $this->id_format($uid); $params['uid'] = $uid; return $this->oauth->post('friendships/create', $params); } /** * 关注一个用户。 * * 成功则返回关注人的资料,目前的最多关注2000人,失败则返回一条字符串的说明。如果已经关注了此人,则返回http 403的状态。关注不存在的ID将返回400。 *
对应API:{@link http://open.weibo.com/wiki/2/friendships/create friendships/create} * * @access public * @param string $screen_name 要关注的用户昵称 * @return array */ function follow_by_name($screen_name) { $params = array(); $params['screen_name'] = $screen_name; return $this->oauth->post('friendships/create', $params); } /** * 根据用户UID批量关注用户 * * 对应API:{@link http://open.weibo.com/wiki/2/friendships/create_batch friendships/create_batch} * * @param string $uids 要关注的用户UID,用半角逗号分隔,最多不超过20个。 * @return array */ function follow_create_batch($uids) { $params = array(); if (is_array($uids) && !empty($uids)) { foreach ($uids as $k => $v) { $this->id_format($uids[$k]); } $params['uids'] = join(',', $uids); } else { $params['uids'] = $uids; } return $this->oauth->post('friendships/create_batch', $params); } /** * 取消关注某用户 * * 取消关注某用户。成功则返回被取消关注人的资料,失败则返回一条字符串的说明。 *
对应API:{@link http://open.weibo.com/wiki/2/friendships/destroy friendships/destroy} * * @access public * @param int $uid 要取消关注的用户UID * @return array */ function unfollow_by_id($uid) { $params = array(); $this->id_format($uid); $params['uid'] = $uid; return $this->oauth->post('friendships/destroy', $params); } /** * 取消关注某用户 * * 取消关注某用户。成功则返回被取消关注人的资料,失败则返回一条字符串的说明。 *
对应API:{@link http://open.weibo.com/wiki/2/friendships/destroy friendships/destroy} * * @access public * @param string $screen_name 要取消关注的用户昵称 * @return array */ function unfollow_by_name($screen_name) { $params = array(); $params['screen_name'] = $screen_name; return $this->oauth->post('friendships/destroy', $params); } /** * 更新当前登录用户所关注的某个好友的备注信息 * * 只能修改当前登录用户所关注的用户的备注信息。否则将给出400错误。 *
对应API:{@link http://open.weibo.com/wiki/2/friendships/remark/update friendships/remark/update} * * @access public * @param int $uid 需要修改备注信息的用户ID。 * @param string $remark 备注信息。 * @return array */ function update_remark($uid, $remark) { $params = array(); $this->id_format($uid); $params['uid'] = $uid; $params['remark'] = $remark; return $this->oauth->post('friendships/remark/update', $params); } /** * 获取当前用户最新私信列表 * * 返回用户的最新n条私信,并包含发送者和接受者的详细资料。 *
对应API:{@link http://open.weibo.com/wiki/2/direct_messages direct_messages} * * @access public * @param int $page 页码 * @param int $count 每次返回的最大记录数,最多返回200条,默认50。 * @param int64 $since_id 返回ID比数值since_id大(比since_id时间晚的)的私信。可选。 * @param int64 $max_id 返回ID不大于max_id(时间不晚于max_id)的私信。可选。 * @return array */ function list_dm($page = 1, $count = 50, $since_id = 0, $max_id = 0) { $params = array(); if ($since_id) { $this->id_format($since_id); $params['since_id'] = $since_id; } if ($max_id) { $this->id_format($max_id); $params['max_id'] = $max_id; } return $this->request_with_pager('direct_messages', $page, $count, $params); } /** * 获取当前用户发送的最新私信列表 * * 返回登录用户已发送最新50条私信。包括发送者和接受者的详细资料。 *
对应API:{@link http://open.weibo.com/wiki/2/direct_messages/sent direct_messages/sent} * * @access public * @param int $page 页码 * @param int $count 每次返回的最大记录数,最多返回200条,默认50。 * @param int64 $since_id 返回ID比数值since_id大(比since_id时间晚的)的私信。可选。 * @param int64 $max_id 返回ID不大于max_id(时间不晚于max_id)的私信。可选。 * @return array */ function list_dm_sent($page = 1, $count = 50, $since_id = 0, $max_id = 0) { $params = array(); if ($since_id) { $this->id_format($since_id); $params['since_id'] = $since_id; } if ($max_id) { $this->id_format($max_id); $params['max_id'] = $max_id; } return $this->request_with_pager('direct_messages/sent', $page, $count, $params); } /** * 获取与当前登录用户有私信往来的用户列表,与该用户往来的最新私信 * * 对应API:{@link http://open.weibo.com/wiki/2/direct_messages/user_list direct_messages/user_list} * * @param int $count 单页返回的记录条数,默认为20。 * @param int $cursor 返回结果的游标,下一页用返回值里的next_cursor,上一页用previous_cursor,默认为0。 * @return array */ function dm_user_list($count = 20, $cursor = 0) { $params = array(); $params['count'] = $count; $params['cursor'] = $cursor; return $this->oauth->get('direct_messages/user_list', $params); } /** * 获取与指定用户的往来私信列表 * * 对应API:{@link http://open.weibo.com/wiki/2/direct_messages/conversation direct_messages/conversation} * * @param int $uid 需要查询的用户的UID。 * @param int $since_id 若指定此参数,则返回ID比since_id大的私信(即比since_id时间晚的私信),默认为0。 * @param int $max_id 若指定此参数,则返回ID小于或等于max_id的私信,默认为0。 * @param int $count 单页返回的记录条数,默认为50。 * @param int $page 返回结果的页码,默认为1。 * @return array */ function dm_conversation($uid, $page = 1, $count = 50, $since_id = 0, $max_id = 0) { $params = array(); $this->id_format($uid); $params['uid'] = $uid; if ($since_id) { $this->id_format($since_id); $params['since_id'] = $since_id; } if ($max_id) { $this->id_format($max_id); $params['max_id'] = $max_id; } $params['count'] = $count; $params['page'] = $page; return $this->oauth->get('direct_messages/conversation', $params); } /** * 根据私信ID批量获取私信内容 * * 对应API:{@link http://open.weibo.com/wiki/2/direct_messages/show_batch direct_messages/show_batch} * * @param string $dmids 需要查询的私信ID,用半角逗号分隔,一次最多50个 * @return array */ function dm_show_batch($dmids) { $params = array(); if (is_array($dmids) && !empty($dmids)) { foreach ($dmids as $k => $v) { $this->id_format($dmids[$k]); } $params['dmids'] = join(',', $dmids); } else { $params['dmids'] = $dmids; } return $this->oauth->get('direct_messages/show_batch', $params); } /** * 发送私信 * * 发送一条私信。成功将返回完整的发送消息。 *
对应API:{@link http://open.weibo.com/wiki/2/direct_messages/new direct_messages/new} * * @access public * @param int $uid 用户UID * @param string $text 要发生的消息内容,文本大小必须小于300个汉字。 * @param int $id 需要发送的微博ID。 * @return array */ function send_dm_by_id($uid, $text, $id = NULL) { $params = array(); $this->id_format($uid); $params['text'] = $text; $params['uid'] = $uid; if ($id) { $this->id_format($id); $params['id'] = $id; } return $this->oauth->post('direct_messages/new', $params); } /** * 发送私信 * * 发送一条私信。成功将返回完整的发送消息。 *
对应API:{@link http://open.weibo.com/wiki/2/direct_messages/new direct_messages/new} * * @access public * @param string $screen_name 用户昵称 * @param string $text 要发生的消息内容,文本大小必须小于300个汉字。 * @param int $id 需要发送的微博ID。 * @return array */ function send_dm_by_name($screen_name, $text, $id = NULL) { $params = array(); $params['text'] = $text; $params['screen_name'] = $screen_name; if ($id) { $this->id_format($id); $params['id'] = $id; } return $this->oauth->post('direct_messages/new', $params); } /** * 删除一条私信 * * 按ID删除私信。操作用户必须为私信的接收人。 *
对应API:{@link http://open.weibo.com/wiki/2/direct_messages/destroy direct_messages/destroy} * * @access public * @param int $did 要删除的私信主键ID * @return array */ function delete_dm($did) { $this->id_format($did); $params = array(); $params['id'] = $did; return $this->oauth->post('direct_messages/destroy', $params); } /** * 批量删除私信 * * 批量删除当前登录用户的私信。出现异常时,返回400错误。 *
对应API:{@link http://open.weibo.com/wiki/2/direct_messages/destroy_batch direct_messages/destroy_batch} * * @access public * @param mixed $dids 欲删除的一组私信ID,用半角逗号隔开,或者由一组评论ID组成的数组。最多20个。例如:"4976494627, 4976262053"或array(4976494627,4976262053); * @return array */ function delete_dms($dids) { $params = array(); if (is_array($dids) && !empty($dids)) { foreach ($dids as $k => $v) { $this->id_format($dids[$k]); } $params['ids'] = join(',', $dids); } else { $params['ids'] = $dids; } return $this->oauth->post('direct_messages/destroy_batch', $params); } /** * 获取用户基本信息 * * 对应API:{@link http://open.weibo.com/wiki/2/account/profile/basic account/profile/basic} * * @param int $uid 需要获取基本信息的用户UID,默认为当前登录用户。 * @return array */ function account_profile_basic($uid = NULL) { $params = array(); if ($uid) { $this->id_format($uid); $params['uid'] = $uid; } return $this->oauth->get('account/profile/basic', $params); } /** * 获取用户的教育信息 * * 对应API:{@link http://open.weibo.com/wiki/2/account/profile/education account/profile/education} * * @param int $uid 需要获取教育信息的用户UID,默认为当前登录用户。 * @return array */ function account_education($uid = NULL) { $params = array(); if ($uid) { $this->id_format($uid); $params['uid'] = $uid; } return $this->oauth->get('account/profile/education', $params); } /** * 批量获取用户的教育信息 * * 对应API:{@link http://open.weibo.com/wiki/2/account/profile/education_batch account/profile/education_batch} * * @param string $uids 需要获取教育信息的用户UID,用半角逗号分隔,最多不超过20。 * @return array */ function account_education_batch($uids) { $params = array(); if (is_array($uids) && !empty($uids)) { foreach ($uids as $k => $v) { $this->id_format($uids[$k]); } $params['uids'] = join(',', $uids); } else { $params['uids'] = $uids; } return $this->oauth->get('account/profile/education_batch', $params); } /** * 获取用户的职业信息 * * 对应API:{@link http://open.weibo.com/wiki/2/account/profile/career account/profile/career} * * @param int $uid 需要获取教育信息的用户UID,默认为当前登录用户。 * @return array */ function account_career($uid = NULL) { $params = array(); if ($uid) { $this->id_format($uid); $params['uid'] = $uid; } return $this->oauth->get('account/profile/career', $params); } /** * 批量获取用户的职业信息 * * 对应API:{@link http://open.weibo.com/wiki/2/account/profile/career_batch account/profile/career_batch} * * @param string $uids 需要获取教育信息的用户UID,用半角逗号分隔,最多不超过20。 * @return array */ function account_career_batch($uids) { $params = array(); if (is_array($uids) && !empty($uids)) { foreach ($uids as $k => $v) { $this->id_format($uids[$k]); } $params['uids'] = join(',', $uids); } else { $params['uids'] = $uids; } return $this->oauth->get('account/profile/career_batch', $params); } /** * 获取隐私信息设置情况 * * 对应API:{@link http://open.weibo.com/wiki/2/account/get_privacy account/get_privacy} * * @access public * @return array */ function get_privacy() { return $this->oauth->get('account/get_privacy'); } /** * 获取所有的学校列表 * * 对应API:{@link http://open.weibo.com/wiki/2/account/profile/school_list account/profile/school_list} * * @param array $query 搜索选项。格式:array('key0'=>'value0', 'key1'=>'value1', ....)。支持的key: * - province int 省份范围,省份ID。 * - city int 城市范围,城市ID。 * - area int 区域范围,区ID。 * - type int 学校类型,1:大学、2:高中、3:中专技校、4:初中、5:小学,默认为1。 * - capital string 学校首字母,默认为A。 * - keyword string 学校名称关键字。 * - count int 返回的记录条数,默认为10。 * 参数keyword与capital二者必选其一,且只能选其一。按首字母capital查询时,必须提供province参数。 * @access public * @return array */ function school_list($query) { $params = $query; return $this->oauth->get('account/profile/school_list', $params); } /** * 获取当前登录用户的API访问频率限制情况 * * 对应API:{@link http://open.weibo.com/wiki/2/account/rate_limit_status account/rate_limit_status} * * @access public * @return array */ function rate_limit_status() { return $this->oauth->get('account/rate_limit_status'); } /** * OAuth授权之后,获取授权用户的UID * * 对应API:{@link http://open.weibo.com/wiki/2/account/get_uid account/get_uid} * * @access public * @return array */ function get_uid() { return $this->oauth->get('account/get_uid'); } /** * 更改用户资料 * * 对应API:{@link http://open.weibo.com/wiki/2/account/profile/basic_update account/profile/basic_update} * * @access public * @param array $profile 要修改的资料。格式:array('key1'=>'value1', 'key2'=>'value2', .....)。 * 支持修改的项: * - screen_name string 用户昵称,不可为空。 * - gender i string 用户性别,m:男、f:女,不可为空。 * - real_name string 用户真实姓名。 * - real_name_visible int 真实姓名可见范围,0:自己可见、1:关注人可见、2:所有人可见。 * - province true int 省份代码ID,不可为空。 * - city true int 城市代码ID,不可为空。 * - birthday string 用户生日,格式:yyyy-mm-dd。 * - birthday_visible int 生日可见范围,0:保密、1:只显示月日、2:只显示星座、3:所有人可见。 * - qq string 用户QQ号码。 * - qq_visible int 用户QQ可见范围,0:自己可见、1:关注人可见、2:所有人可见。 * - msn string 用户MSN。 * - msn_visible int 用户MSN可见范围,0:自己可见、1:关注人可见、2:所有人可见。 * - url string 用户博客地址。 * - url_visible int 用户博客地址可见范围,0:自己可见、1:关注人可见、2:所有人可见。 * - credentials_type int 证件类型,1:身份证、2:学生证、3:军官证、4:护照。 * - credentials_num string 证件号码。 * - email string 用户常用邮箱地址。 * - email_visible int 用户常用邮箱地址可见范围,0:自己可见、1:关注人可见、2:所有人可见。 * - lang string 语言版本,zh_cn:简体中文、zh_tw:繁体中文。 * - description string 用户描述,最长不超过70个汉字。 * 填写birthday参数时,做如下约定: * - 只填年份时,采用1986-00-00格式; * - 只填月份时,采用0000-08-00格式; * - 只填某日时,采用0000-00-28格式。 * @return array */ function update_profile($profile) { return $this->oauth->post('account/profile/basic_update', $profile); } /** * 设置教育信息 * * 对应API:{@link http://open.weibo.com/wiki/2/account/profile/edu_update account/profile/edu_update} * * @access public * @param array $edu_update 要修改的学校信息。格式:array('key1'=>'value1', 'key2'=>'value2', .....)。 * 支持设置的项: * - type int 学校类型,1:大学、2:高中、3:中专技校、4:初中、5:小学,默认为1。必填参数 * - school_id ` int 学校代码,必填参数 * - id string 需要修改的教育信息ID,不传则为新建,传则为更新。 * - year int 入学年份,最小为1900,最大不超过当前年份 * - department string 院系或者班别。 * - visible int 开放等级,0:仅自己可见、1:关注的人可见、2:所有人可见。 * @return array */ function edu_update($edu_update) { return $this->oauth->post('account/profile/edu_update', $edu_update); } /** * 根据学校ID删除用户的教育信息 * * 对应API:{@link http://open.weibo.com/wiki/2/account/profile/edu_destroy account/profile/edu_destroy} * * @param int $id 教育信息里的学校ID。 * @return array */ function edu_destroy($id) { $this->id_format($id); $params = array(); $params['id'] = $id; return $this->oauth->post('account/profile/edu_destroy', $params); } /** * 设置职业信息 * * 对应API:{@link http://open.weibo.com/wiki/2/account/profile/car_update account/profile/car_update} * * @param array $car_update 要修改的职业信息。格式:array('key1'=>'value1', 'key2'=>'value2', .....)。 * 支持设置的项: * - id string 需要更新的职业信息ID。 * - start int 进入公司年份,最小为1900,最大为当年年份。 * - end int 离开公司年份,至今填0。 * - department string 工作部门。 * - visible int 可见范围,0:自己可见、1:关注人可见、2:所有人可见。 * - province int 省份代码ID,不可为空值。 * - city int 城市代码ID,不可为空值。 * - company string 公司名称,不可为空值。 * 参数province与city二者必选其一
* 参数id为空,则为新建职业信息,参数company变为必填项,参数id非空,则为更新,参数company可选 * @return array */ function car_update($car_update) { return $this->oauth->post('account/profile/car_update', $car_update); } /** * 根据公司ID删除用户的职业信息 * * 对应API:{@link http://open.weibo.com/wiki/2/account/profile/car_destroy account/profile/car_destroy} * * @access public * @param int $id 职业信息里的公司ID * @return array */ function car_destroy($id) { $this->id_format($id); $params = array(); $params['id'] = $id; return $this->oauth->post('account/profile/car_destroy', $params); } /** * 更改头像 * * 对应API:{@link http://open.weibo.com/wiki/2/account/avatar/upload account/avatar/upload} * * @param string $image_path 要上传的头像路径, 支持url。[只支持png/jpg/gif三种格式, 增加格式请修改get_image_mime方法] 必须为小于700K的有效的GIF, JPG图片. 如果图片大于500像素将按比例缩放。 * @return array */ function update_profile_image($image_path) { $params = array(); $params['image'] = "@{$image_path}"; return $this->oauth->post('account/avatar/upload', $params); } /** * 设置隐私信息 * * 对应API:{@link http://open.weibo.com/wiki/2/account/update_privacy account/update_privacy} * * @param array $privacy_settings 要修改的隐私设置。格式:array('key1'=>'value1', 'key2'=>'value2', .....)。 * 支持设置的项: * - comment int 是否可以评论我的微博,0:所有人、1:关注的人,默认为0。 * - geo int 是否开启地理信息,0:不开启、1:开启,默认为1。 * - message int 是否可以给我发私信,0:所有人、1:关注的人,默认为0。 * - realname int 是否可以通过真名搜索到我,0:不可以、1:可以,默认为0。 * - badge int 勋章是否可见,0:不可见、1:可见,默认为1。 * - mobile int 是否可以通过手机号码搜索到我,0:不可以、1:可以,默认为0。 * 以上参数全部选填 * @return array */ function update_privacy($privacy_settings) { return $this->oauth->post('account/update_privacy', $privacy_settings); } /** * 获取当前用户的收藏列表 * * 返回用户的发布的最近20条收藏信息,和用户收藏页面返回内容是一致的。 *
对应API:{@link http://open.weibo.com/wiki/2/favorites favorites} * * @access public * @param int $page 返回结果的页码,默认为1。 * @param int $count 单页返回的记录条数,默认为50。 * @return array */ function get_favorites($page = 1, $count = 50) { $params = array(); $params['page'] = intval($page); $params['count'] = intval($count); return $this->oauth->get('favorites', $params); } /** * 根据收藏ID获取指定的收藏信息 * * 根据收藏ID获取指定的收藏信息。 *
对应API:{@link http://open.weibo.com/wiki/2/favorites/show favorites/show} * * @access public * @param int $id 需要查询的收藏ID。 * @return array */ function favorites_show($id) { $params = array(); $this->id_format($id); $params['id'] = $id; return $this->oauth->get('favorites/show', $params); } /** * 根据标签获取当前登录用户该标签下的收藏列表 * * 对应API:{@link http://open.weibo.com/wiki/2/favorites/by_tags favorites/by_tags} * * * @param int $tid 需要查询的标签ID。' * @param int $count 单页返回的记录条数,默认为50。 * @param int $page 返回结果的页码,默认为1。 * @return array */ function favorites_by_tags($tid, $page = 1, $count = 50) { $params = array(); $params['tid'] = $tid; $params['count'] = $count; $params['page'] = $page; return $this->oauth->get('favorites/by_tags', $params); } /** * 获取当前登录用户的收藏标签列表 * * 对应API:{@link http://open.weibo.com/wiki/2/favorites/tags favorites/tags} * * @access public * @param int $count 单页返回的记录条数,默认为50。 * @param int $page 返回结果的页码,默认为1。 * @return array */ function favorites_tags($page = 1, $count = 50) { $params = array(); $params['count'] = $count; $params['page'] = $page; return $this->oauth->get('favorites/tags', $params); } /** * 收藏一条微博信息 * * 对应API:{@link http://open.weibo.com/wiki/2/favorites/create favorites/create} * * @access public * @param int $sid 收藏的微博id * @return array */ function add_to_favorites($sid) { $this->id_format($sid); $params = array(); $params['id'] = $sid; return $this->oauth->post('favorites/create', $params); } /** * 删除微博收藏。 * * 对应API:{@link http://open.weibo.com/wiki/2/favorites/destroy favorites/destroy} * * @access public * @param int $id 要删除的收藏微博信息ID. * @return array */ function remove_from_favorites($id) { $this->id_format($id); $params = array(); $params['id'] = $id; return $this->oauth->post('favorites/destroy', $params); } /** * 批量删除微博收藏。 * * 批量删除当前登录用户的收藏。出现异常时,返回HTTP400错误。 *
对应API:{@link http://open.weibo.com/wiki/2/favorites/destroy_batch favorites/destroy_batch} * * @access public * @param mixed $fids 欲删除的一组私信ID,用半角逗号隔开,或者由一组评论ID组成的数组。最多20个。例如:"231101027525486630,201100826122315375"或array(231101027525486630,201100826122315375); * @return array */ function remove_from_favorites_batch($fids) { $params = array(); if (is_array($fids) && !empty($fids)) { foreach ($fids as $k => $v) { $this->id_format($fids[$k]); } $params['ids'] = join(',', $fids); } else { $params['ids'] = $fids; } return $this->oauth->post('favorites/destroy_batch', $params); } /** * 更新一条收藏的收藏标签 * * 对应API:{@link http://open.weibo.com/wiki/2/favorites/tags/update favorites/tags/update} * * @access public * @param int $id 需要更新的收藏ID。 * @param string $tags 需要更新的标签内容,用半角逗号分隔,最多不超过2条。 * @return array */ function favorites_tags_update($id, $tags) { $params = array(); $params['id'] = $id; if (is_array($tags) && !empty($tags)) { foreach ($tags as $k => $v) { $this->id_format($tags[$k]); } $params['tags'] = join(',', $tags); } else { $params['tags'] = $tags; } return $this->oauth->post('favorites/tags/update', $params); } /** * 更新当前登录用户所有收藏下的指定标签 * * 对应API:{@link http://open.weibo.com/wiki/2/favorites/tags/update_batch favorites/tags/update_batch} * * @param int $tid 需要更新的标签ID。必填 * @param string $tag 需要更新的标签内容。必填 * @return array */ function favorites_update_batch($tid, $tag) { $params = array(); $params['tid'] = $tid; $params['tag'] = $tag; return $this->oauth->post('favorites/tags/update_batch', $params); } /** * 删除当前登录用户所有收藏下的指定标签 * * 删除标签后,该用户所有收藏中,添加了该标签的收藏均解除与该标签的关联关系 *
对应API:{@link http://open.weibo.com/wiki/2/favorites/tags/destroy_batch favorites/tags/destroy_batch} * * @param int $tid 需要更新的标签ID。必填 * @return array */ function favorites_tags_destroy_batch($tid) { $params = array(); $params['tid'] = $tid; return $this->oauth->post('favorites/tags/destroy_batch', $params); } /** * 获取某用户的话题 * * 对应API:{@link http://open.weibo.com/wiki/2/trends trends} * * @param int $uid 查询用户的ID。默认为当前用户。可选。 * @param int $page 指定返回结果的页码。可选。 * @param int $count 单页大小。缺省值10。可选。 * @return array */ function get_trends($uid = NULL, $page = 1, $count = 10) { $params = array(); if ($uid) { $params['uid'] = $uid; } else { $user_info = $this->get_uid(); $params['uid'] = $user_info['uid']; } $this->id_format($params['uid']); $params['page'] = $page; $params['count'] = $count; return $this->oauth->get('trends', $params); } /** * 判断当前用户是否关注某话题 * * 对应API:{@link http://open.weibo.com/wiki/2/trends/is_follow trends/is_follow} * * @access public * @param string $trend_name 话题关键字。 * @return array */ function trends_is_follow($trend_name) { $params = array(); $params['trend_name'] = $trend_name; return $this->oauth->get('trends/is_follow', $params); } /** * 返回最近一小时内的热门话题 * * 对应API:{@link http://open.weibo.com/wiki/2/trends/hourly trends/hourly} * * @param int $base_app 是否基于当前应用来获取数据。1表示基于当前应用来获取数据,默认为0。可选。 * @return array */ function hourly_trends($base_app = 0) { $params = array(); $params['base_app'] = $base_app; return $this->oauth->get('trends/hourly', $params); } /** * 返回最近一天内的热门话题 * * 对应API:{@link http://open.weibo.com/wiki/2/trends/daily trends/daily} * * @param int $base_app 是否基于当前应用来获取数据。1表示基于当前应用来获取数据,默认为0。可选。 * @return array */ function daily_trends($base_app = 0) { $params = array(); $params['base_app'] = $base_app; return $this->oauth->get('trends/daily', $params); } /** * 返回最近一周内的热门话题 * * 对应API:{@link http://open.weibo.com/wiki/2/trends/weekly trends/weekly} * * @access public * @param int $base_app 是否基于当前应用来获取数据。1表示基于当前应用来获取数据,默认为0。可选。 * @return array */ function weekly_trends($base_app = 0) { $params = array(); $params['base_app'] = $base_app; return $this->oauth->get('trends/weekly', $params); } /** * 关注某话题 * * 对应API:{@link http://open.weibo.com/wiki/2/trends/follow trends/follow} * * @access public * @param string $trend_name 要关注的话题关键词。 * @return array */ function follow_trends($trend_name) { $params = array(); $params['trend_name'] = $trend_name; return $this->oauth->post('trends/follow', $params); } /** * 取消对某话题的关注 * * 对应API:{@link http://open.weibo.com/wiki/2/trends/destroy trends/destroy} * * @access public * @param int $tid 要取消关注的话题ID。 * @return array */ function unfollow_trends($tid) { $this->id_format($tid); $params = array(); $params['trend_id'] = $tid; return $this->oauth->post('trends/destroy', $params); } /** * 返回指定用户的标签列表 * * 对应API:{@link http://open.weibo.com/wiki/2/tags tags} * * @param int $uid 查询用户的ID。默认为当前用户。可选。 * @param int $page 指定返回结果的页码。可选。 * @param int $count 单页大小。缺省值20,最大值200。可选。 * @return array */ function get_tags($uid = NULL, $page = 1, $count = 20) { $params = array(); if ($uid) { $params['uid'] = $uid; } else { $user_info = $this->get_uid(); $params['uid'] = $user_info['uid']; } $this->id_format($params['uid']); $params['page'] = $page; $params['count'] = $count; return $this->oauth->get('tags', $params); } /** * 批量获取用户的标签列表 * * 对应API:{@link http://open.weibo.com/wiki/2/tags/tags_batch tags/tags_batch} * * @param string $uids 要获取标签的用户ID。最大20,逗号分隔。必填 * @return array */ function get_tags_batch($uids) { $params = array(); if (is_array($uids) && !empty($uids)) { foreach ($uids as $k => $v) { $this->id_format($uids[$k]); } $params['uids'] = join(',', $uids); } else { $params['uids'] = $uids; } return $this->oauth->get('tags/tags_batch', $params); } /** * 返回用户感兴趣的标签 * * 对应API:{@link http://open.weibo.com/wiki/2/tags/suggestions tags/suggestions} * * @access public * @param int $count 单页大小。缺省值10,最大值10。可选。 * @return array */ function get_suggest_tags($count = 10) { $params = array(); $params['count'] = intval($count); return $this->oauth->get('tags/suggestions', $params); } /** * 为当前登录用户添加新的用户标签 * * 对应API:{@link http://open.weibo.com/wiki/2/tags/create tags/create} * * @access public * @param mixed $tags 要创建的一组标签,每个标签的长度不可超过7个汉字,14个半角字符。多个标签之间用逗号间隔,或由多个标签构成的数组。如:"abc,drf,efgh,tt"或array("abc", "drf", "efgh", "tt") * @return array */ function add_tags($tags) { $params = array(); if (is_array($tags) && !empty($tags)) { $params['tags'] = join(',', $tags); } else { $params['tags'] = $tags; } return $this->oauth->post('tags/create', $params); } /** * 删除标签 * * 对应API:{@link http://open.weibo.com/wiki/2/tags/destroy tags/destroy} * * @access public * @param int $tag_id 标签ID,必填参数 * @return array */ function delete_tag($tag_id) { $params = array(); $params['tag_id'] = $tag_id; return $this->oauth->post('tags/destroy', $params); } /** * 批量删除标签 * * 对应API:{@link http://open.weibo.com/wiki/2/tags/destroy_batch tags/destroy_batch} * * @access public * @param mixed $ids 必选参数,要删除的tag id,多个id用半角逗号分割,最多10个。或由多个tag id构成的数组。如:“553,554,555"或array(553, 554, 555) * @return array */ function delete_tags($ids) { $params = array(); if (is_array($ids) && !empty($ids)) { $params['ids'] = join(',', $ids); } else { $params['ids'] = $ids; } return $this->oauth->post('tags/destroy_batch', $params); } /** * 验证昵称是否可用,并给予建议昵称 * * 对应API:{@link http://open.weibo.com/wiki/2/register/verify_nickname register/verify_nickname} * * @param string $nickname 需要验证的昵称。4-20个字符,支持中英文、数字、"_"或减号。必填 * @return array */ function verify_nickname($nickname) { $params = array(); $params['nickname'] = $nickname; return $this->oauth->get('register/verify_nickname', $params); } /** * 搜索用户时的联想搜索建议 * * 对应API:{@link http://open.weibo.com/wiki/2/search/suggestions/users search/suggestions/users} * * @param string $q 搜索的关键字,必须做URLencoding。必填,中间最好不要出现空格 * @param int $count 返回的记录条数,默认为10。 * @return array */ function search_users($q, $count = 10) { $params = array(); $params['q'] = $q; $params['count'] = $count; return $this->oauth->get('search/suggestions/users', $params); } /** * 搜索微博时的联想搜索建议 * * 对应API:{@link http://open.weibo.com/wiki/2/search/suggestions/statuses search/suggestions/statuses} * * @param string $q 搜索的关键字,必须做URLencoding。必填 * @param int $count 返回的记录条数,默认为10。 * @return array */ function search_statuses($q, $count = 10) { $params = array(); $params['q'] = $q; $params['count'] = $count; return $this->oauth->get('search/suggestions/statuses', $params); } /** * 搜索学校时的联想搜索建议 * * 对应API:{@link http://open.weibo.com/wiki/2/search/suggestions/schools search/suggestions/schools} * * @param string $q 搜索的关键字,必须做URLencoding。必填 * @param int $count 返回的记录条数,默认为10。 * @param int type 学校类型,0:全部、1:大学、2:高中、3:中专技校、4:初中、5:小学,默认为0。选填 * @return array */ function search_schools($q, $count = 10, $type = 1) { $params = array(); $params['q'] = $q; $params['count'] = $count; $params['type'] = $type; return $this->oauth->get('search/suggestions/schools', $params); } /** * 搜索公司时的联想搜索建议 * * 对应API:{@link http://open.weibo.com/wiki/2/search/suggestions/companies search/suggestions/companies} * * @param string $q 搜索的关键字,必须做URLencoding。必填 * @param int $count 返回的记录条数,默认为10。 * @return array */ function search_companies($q, $count = 10) { $params = array(); $params['q'] = $q; $params['count'] = $count; return $this->oauth->get('search/suggestions/companies', $params); } /** * @用户时的联想建议 * * 对应API:{@link http://open.weibo.com/wiki/2/search/suggestions/at_users search/suggestions/at_users} * * @param string $q 搜索的关键字,必须做URLencoding。必填 * @param int $count 返回的记录条数,默认为10。 * @param int $type 联想类型,0:关注、1:粉丝。必填 * @param int $range 联想范围,0:只联想关注人、1:只联想关注人的备注、2:全部,默认为2。选填 * @return array */ function search_at_users($q, $count = 10, $type = 0, $range = 2) { $params = array(); $params['q'] = $q; $params['count'] = $count; $params['type'] = $type; $params['range'] = $range; return $this->oauth->get('search/suggestions/at_users', $params); } /** * 搜索与指定的一个或多个条件相匹配的微博 * * 对应API:{@link http://open.weibo.com/wiki/2/search/statuses search/statuses} * * @param array $query 搜索选项。格式:array('key0'=>'value0', 'key1'=>'value1', ....)。支持的key: * - q string 搜索的关键字,必须进行URLencode。 * - filter_ori int 过滤器,是否为原创,0:全部、1:原创、2:转发,默认为0。 * - filter_pic int 过滤器。是否包含图片,0:全部、1:包含、2:不包含,默认为0。 * - fuid int 搜索的微博作者的用户UID。 * - province int 搜索的省份范围,省份ID。 * - city int 搜索的城市范围,城市ID。 * - starttime int 开始时间,Unix时间戳。 * - endtime int 结束时间,Unix时间戳。 * - count int 单页返回的记录条数,默认为10。 * - page int 返回结果的页码,默认为1。 * - needcount boolean 返回结果中是否包含返回记录数,true:返回、false:不返回,默认为false。 * - base_app int 是否只获取当前应用的数据。0为否(所有数据),1为是(仅当前应用),默认为0。 * needcount参数不同,会导致相应的返回值结构不同 * 以上参数全部选填 * @return array */ function search_statuses_high($query) { return $this->oauth->get('search/statuses', $query); } /** * 通过关键词搜索用户 * * 对应API:{@link http://open.weibo.com/wiki/2/search/users search/users} * * @param array $query 搜索选项。格式:array('key0'=>'value0', 'key1'=>'value1', ....)。支持的key: * - q string 搜索的关键字,必须进行URLencode。 * - snick int 搜索范围是否包含昵称,0:不包含、1:包含。 * - sdomain int 搜索范围是否包含个性域名,0:不包含、1:包含。 * - sintro int 搜索范围是否包含简介,0:不包含、1:包含。 * - stag int 搜索范围是否包含标签,0:不包含、1:包含。 * - province int 搜索的省份范围,省份ID。 * - city int 搜索的城市范围,城市ID。 * - gender string 搜索的性别范围,m:男、f:女。 * - comorsch string 搜索的公司学校名称。 * - sort int 排序方式,1:按更新时间、2:按粉丝数,默认为1。 * - count int 单页返回的记录条数,默认为10。 * - page int 返回结果的页码,默认为1。 * - base_app int 是否只获取当前应用的数据。0为否(所有数据),1为是(仅当前应用),默认为0。 * 以上所有参数全部选填 * @return array */ function search_users_keywords($query) { return $this->oauth->get('search/users', $query); } /** * 获取系统推荐用户 * * 返回系统推荐的用户列表。 *
对应API:{@link http://open.weibo.com/wiki/2/suggestions/users/hot suggestions/users/hot} * * @access public * @param string $category 分类,可选参数,返回某一类别的推荐用户,默认为 default。如果不在以下分类中,返回空列表:
* - default:人气关注 * - ent:影视名星 * - hk_famous:港台名人 * - model:模特 * - cooking:美食&健康 * - sport:体育名人 * - finance:商界名人 * - tech:IT互联网 * - singer:歌手 * - writer:作家 * - moderator:主持人 * - medium:媒体总编 * - stockplayer:炒股高手 * @return array */ function hot_users($category = "default") { $params = array(); $params['category'] = $category; return $this->oauth->get('suggestions/users/hot', $params); } /** * 获取用户可能感兴趣的人 * * 对应API:{@link http://open.weibo.com/wiki/2/suggestions/users/may_interested suggestions/users/may_interested} * * @access public * @param int $page 返回结果的页码,默认为1。 * @param int $count 单页返回的记录条数,默认为10。 * @return array * @ignore */ function suggestions_may_interested($page = 1, $count = 10) { $params = array(); $params['page'] = $page; $params['count'] = $count; return $this->oauth->get('suggestions/users/may_interested', $params); } /** * 根据一段微博正文推荐相关微博用户。 * * 对应API:{@link http://open.weibo.com/wiki/2/suggestions/users/by_status suggestions/users/by_status} * * @access public * @param string $content 微博正文内容。 * @param int $num 返回结果数目,默认为10。 * @return array */ function suggestions_users_by_status($content, $num = 10) { $params = array(); $params['content'] = $content; $params['num'] = $num; return $this->oauth->get('suggestions/users/by_status', $params); } /** * 热门收藏 * * 对应API:{@link http://open.weibo.com/wiki/2/suggestions/favorites/hot suggestions/favorites/hot} * * @param int $count 每页返回结果数,默认20。选填 * @param int $page 返回页码,默认1。选填 * @return array */ function hot_favorites($page = 1, $count = 20) { $params = array(); $params['count'] = $count; $params['page'] = $page; return $this->oauth->get('suggestions/favorites/hot', $params); } /** * 把某人标识为不感兴趣的人 * * 对应API:{@link http://open.weibo.com/wiki/2/suggestions/users/not_interested suggestions/users/not_interested} * * @param int $uid 不感兴趣的用户的UID。 * @return array */ function put_users_not_interested($uid) { $params = array(); $params['uid'] = $uid; return $this->oauth->post('suggestions/users/not_interested', $params); } // ========================================= /** * @ignore */ protected function request_with_pager($url, $page = false, $count = false, $params = array()) { if ($page) $params['page'] = $page; if ($count) $params['count'] = $count; return $this->oauth->get($url, $params); } /** * @ignore */ protected function request_with_uid($url, $uid_or_name, $page = false, $count = false, $cursor = false, $post = false, $params = array()) { if ($page) $params['page'] = $page; if ($count) $params['count'] = $count; if ($cursor) $params['cursor'] = $cursor; if ($post) $method = 'post'; else $method = 'get'; if ($uid_or_name !== NULL) { $this->id_format($uid_or_name); $params['id'] = $uid_or_name; } return $this->oauth->$method($url, $params); } /** * @ignore */ protected function id_format(&$id) { if (is_float($id)) { $id = number_format($id, 0, '', ''); } elseif (is_string($id)) { $id = trim($id); } } }