NAME Net::SinaWeibo - A simple and lightweight OAuth api for SinaWeibo VERSION version 0.003 SYNOPSIS # from sinaweibo app setting my $app_key = 'xxxx'; my $app_key_secret = 'xxxxxxxxx'; my $client = Net::SinaWeibo->new( app_key => $app_key, app_key_secret => $app_key_secret); # authorization my $callback_url = 'http://youdomain.com/app_callback'; my $url = $client->get_authorize_url(callback_url => $callback_url); # or don't use callback_url,just like a desktop client. my $url = $client->get_authorize_url; # now $client hold the request_token, but you must authorize your app first. # let user go to visit the authorize url. say 'Please goto this url:',$url; # save these tokens to your file. Net::SinaWeibo->save_tokens('~/app/var/tokens/my.tokens', app_key => $app_key, app_key_secret => $app_key_secret, _request_token => $client->request_token->token, _request_token_secret => $client->request_token->secret, ); # later,you can load tokens my %tokens = Net::SinaWeibo->load_tokens '~/app/var/tokens/my.tokens'; # After user authorized,you can request access_token with the request token my $client = Net::SinaWeibo->new( app_key => $tokens{app_key}, app_secret => $tokens{app_secret}, tokens => { request_token => $tokens{_request_token}, request_token_secret => $tokens{_request_token_secret}, } ); my $verifier = '5123876'; my ($access_token,$access_token_secret) = $client->get_access_token( verifier => $verifier, ); # now you can retrieve any restricted resources. my $friends = $client->friends; # any api can pass any specific parameters my $latest_mentions = $client->mentions since_id => 25892384,count => 10,page => 1; # upload also support. my $ok = $client->upload(status => 'Hello,this first image file', pic => 'images/demo.jpg'); # profile image my $ok = update_profile_image(image => 'images/my_avatar.jpg'); # enjoy! DESCRIPTION This is a lite OAuth client for SinaWeibo(http://t.sina.com.cn/). METHODS new(params) my $client = Net::SinaWeibo->new( app_key => 'sinaweibo_app_key', app_secret => 'sina_weibo_app_secret', # optional,you can pass access_token/request_token tokens => { access_token => 'xxxxxx', access_token_secret => 'xxxxxxxx', # or request_token => 'xxxxxxx', request_token_secret => 'xxxxx', } ); get_authorize_url(%params) parameters callback_url Url which service provider redirect end-user to after authorization. Get the URL to authorize a user as a URI object. get_request_token Request the request token and request token secret for this user. This is called automatically by "get_authorize_url" if necessary. get_access_token(%params) parameters verifier Verfication code which SinaWeibo returns. token Request token object. Optional, if you has been set request_token. my $access_token = $sina->get_access_token(verifier => '589893'); # or my $access_token = $sina->get_access_token(verifier => '589893',token => $request_token); Request the access token for this user. The user must have authorized this app at the url given by "get_authorize_url" first. Returns the access token but also sets them internally so that after calling this method you can immediately call a restricted method. last_api Get the last called api(uri) last_api_error Get the last api error hash ref. If the error message is not any valid error response, will just return the raw response content. load_tokens <file> my %tokens = Net::SinaWeibo->load_tokens('saved.tokens'); A convenience method for loading tokens from a config file. Returns a hash with the token names suitable for passing to "new()". Returns an empty hash if the file doesn't exist. last_api_error_code Get last api error_code, which return by provider. If provider reponse is not valid JSON message, it's just the http status code. last_api_error_subcode Get detail error code about the api error (like 400 serial). save_tokens <file> [token[s] hash] Net::SinaWeibo->save_tokens( consumer_token => 'xxxx', consumer_secret => 'xxxx', _request_token => 'xxxxxx', _request_token_secret => 'xxxxx', _access_token => 'xxxxx', _access_secret => 'xxxxx, ) A convenience method to save a hash of tokens out to the given file. SinaWeibo API METHODS Follow are generated proxy method for SinaWeibo API. Recent document please visit <http://open.t.sina.com.cn/wiki/> public_timeline 返回最新更新的20æ¡å¾®åšæ¶ˆæ¯ã€‚ count: æ¯æ¬¡è¿”回的最大记录数,ä¸èƒ½è¶…过200,默认20. <http://open.t.sina.com.cn/wiki/index.php/Statuses/public_timeline> friends_timeline home_timeline 返回用户所有关注用户最新næ¡å¾®åšä¿¡æ¯ã€‚和用户“我的首页â€è¿”回内容相åŒã€‚ since_id: å¾®åšä¿¡æ¯ID. åªè¿”回ID比since_id大(比since_id时间晚的)的微åšä¿¡æ¯å†…容。 max_id: å¾®åšä¿¡æ¯ID. 返回IDä¸å¤§äºŽmax_idçš„å¾®åšä¿¡æ¯å†…容。 count: æ¯æ¬¡è¿”回的最大记录数,ä¸èƒ½è¶…过200,默认20. page: 返回结果的页åºå·ã€‚注æ„:有分页é™åˆ¶ã€‚æ ¹æ®ç”¨æˆ·å…³æ³¨å¯¹è±¡å‘表的数é‡ï¼Œé€šå¸¸æœ€å¤šè¿”回1,000æ¡æœ€æ–°å¾®åšåˆ†é¡µå†…容, 默认1 <http://open.t.sina.com.cn/wiki/index.php/Statuses/friends_timeline> user_timeline 获å–用户å‘布的微åšä¿¡æ¯åˆ—表 id: å¯é€‰å‚æ•°. æ ¹æ®æŒ‡å®šç”¨æˆ·UID或微åšæ˜µç§°æ¥è¿”回微åšä¿¡æ¯ã€‚ user_id: å¯é€‰å‚æ•°. 用户UID,主è¦æ˜¯ç”¨æ¥åŒºåˆ†ç”¨æˆ·UIDè·Ÿå¾®åšæ˜µç§°ä¸€æ ·ï¼Œäº§ç”Ÿæ§ä¹‰çš„时候,特别是在微åšæ˜µç§°ä¸ºæ•°å—导致和用户Uidå‘生æ§ä¹‰ã€‚ screen_name:å¯é€‰å‚æ•°.å¾®åšæ˜µç§°ï¼Œä¸»è¦æ˜¯ç”¨æ¥åŒºåˆ†ç”¨æˆ·UIDè·Ÿå¾®åšæ˜µç§°ä¸€æ ·ï¼Œäº§ç”Ÿæ§ä¹‰çš„时候。 since_id:å¯é€‰å‚数(微åšä¿¡æ¯ID). åªè¿”回ID比since_id大(比since_id时间晚的)的微åšä¿¡æ¯å†…容 max_id: å¯é€‰å‚数(微åšä¿¡æ¯ID). 返回IDä¸å¤§äºŽmax_idçš„å¾®åšä¿¡æ¯å†…容。 count: å¯é€‰å‚æ•°. æ¯æ¬¡è¿”回的最大记录数,最多返回200æ¡ï¼Œé»˜è®¤20。 page: å¯é€‰å‚æ•°. 分页返回。注æ„:最多返回200æ¡åˆ†é¡µå†…容。 <http://open.t.sina.com.cn/wiki/index.php/Statuses/user_timeline> mentions 获å–@当å‰ç”¨æˆ·çš„å¾®åšåˆ—表 since_id. å¯é€‰å‚æ•°. 返回ID比数值since_id大(比since_id时间晚的)的æ到。 max_id. å¯é€‰å‚æ•°. 返回IDä¸å¤§äºŽmax_id(时间ä¸æ™šäºŽmax_id)çš„æ到。 count. å¯é€‰å‚æ•°. æ¯æ¬¡è¿”回的最大记录数(å³é¡µé¢å¤§å°ï¼‰ï¼Œä¸å¤§äºŽ200,默认为20。 page. å¯é€‰å‚æ•°. 返回结果的页åºå·ã€‚注æ„:有分页é™åˆ¶ã€‚ <http://open.t.sina.com.cn/wiki/index.php/Statuses/mentions> comments_timeline 获å–当å‰ç”¨æˆ·å‘é€åŠæ”¶åˆ°çš„评论列表 since_id: å¯é€‰å‚数(评论ID). åªè¿”回ID比since_id大(比since_id时间晚的)的评论。 max_id: å¯é€‰å‚数(评论ID). 返回IDä¸å¤§äºŽmax_id的评论。 count: å¯é€‰å‚æ•°. æ¯æ¬¡è¿”回的最大记录数,ä¸å¤§äºŽ200,默认20。 page: å¯é€‰å‚æ•°. 返回结果的页åºå·ã€‚注æ„:有分页é™åˆ¶ã€‚ <http://open.t.sina.com.cn/wiki/index.php/Statuses/comments_timeline> comments_by_me 获å–当å‰ç”¨æˆ·å‘出的评论 since_id: å¯é€‰å‚数(评论ID). åªè¿”回ID比since_id大(比since_id时间晚的)的评论。 max_id: å¯é€‰å‚数(评论ID). 返回IDä¸å¤§äºŽmax_id的评论。 count: å¯é€‰å‚æ•°. æ¯æ¬¡è¿”回的最大记录数,ä¸å¤§äºŽ200,默认20。 page: å¯é€‰å‚æ•°. 返回结果的页åºå·ã€‚注æ„:有分页é™åˆ¶ã€‚ <http://open.t.sina.com.cn/wiki/index.php/Statuses/comments_by_me> comments_to_me 获å–当å‰ç”¨æˆ·æ”¶åˆ°çš„评论 since_id: å¯é€‰å‚数(评论ID). åªè¿”回ID比since_id大(比since_id时间晚的)的评论。 max_id: å¯é€‰å‚数(评论ID). 返回IDä¸å¤§äºŽmax_id的评论。 count: å¯é€‰å‚æ•°. æ¯æ¬¡è¿”回的最大记录数,ä¸å¤§äºŽ200,默认20。 page: å¯é€‰å‚æ•°. 返回结果的页åºå·ã€‚注æ„:有分页é™åˆ¶ã€‚ <http://open.t.sina.com.cn/wiki/index.php/Statuses/comments_to_me> comments 获å–指定微åšçš„评论列表 id. 必选å‚æ•°. 返回指定的微åšID count. å¯é€‰å‚æ•°. æ¯æ¬¡è¿”回的最大记录数(å³é¡µé¢å¤§å°ï¼‰ï¼Œä¸å¤§äºŽ200,默认为20。 page. å¯é€‰å‚æ•°. 返回结果的页åºå· <http://open.t.sina.com.cn/wiki/index.php/Statuses/comments> status_counts 批é‡èŽ·å–一组微åšçš„评论数åŠè½¬å‘æ•°,一次请求最多获å–100个。 ids. å¿…å¡«å‚æ•°. å¾®åšIDå·åˆ—表,用逗å·éš”å¼€ <http://open.t.sina.com.cn/wiki/index.php/Statuses/counts> status_unread 获å–当å‰ç”¨æˆ·æœªè¯»æ¶ˆæ¯æ•° with_new_status å¯é€‰å‚数,默认为0。1表示结果包å«æ˜¯å¦æœ‰æ–°å¾®åšï¼Œ0表示结果ä¸åŒ…å«æ˜¯å¦æœ‰æ–°å¾®åšã€‚ since_id å¯é€‰å‚æ•° å‚数值为微åšid,返回æ¤æ¡id之åŽï¼Œæ˜¯å¦æœ‰æ–°å¾®åšäº§ç”Ÿï¼Œæœ‰è¿”回1,没有返回0 <http://open.t.sina.com.cn/wiki/index.php/Statuses/unread> status_reset_count 未读消æ¯æ•°æ¸…é›¶æŽ¥å£ type 需è¦æ¸…零的计数类别,值为下列四个之一:1--评论数,2--@数,3--ç§ä¿¡æ•°ï¼Œ4--关注我的数。 <http://open.t.sina.com.cn/wiki/index.php/Statuses/reset_count> emotions 表情接å£ï¼ŒèŽ·å–表情列表 type:表情类别,å¯é€‰å‚数,"face":普通表情,"ani":é”法表情,"cartoon":动漫表情;默认为"face" language:è¯è¨€ç±»åˆ«ï¼Œå¯é€‰å‚数,"cnname"简体,"twname"ç¹ä½“;默认为"cnname" <http://open.t.sina.com.cn/wiki/index.php/Emotions> show_status æ ¹æ®ID获å–å•æ¡å¾®åšä¿¡æ¯å†…容 id. å¿…é¡»å‚æ•°(å¾®åšä¿¡æ¯ID),è¦èŽ·å–å·²å‘表的微åšID,如IDä¸å˜åœ¨è¿”回空 <http://open.t.sina.com.cn/wiki/index.php/Statuses/show> status_url($user_id,$status_id) è¿”å›žæ ¹æ®å¾®åšID和用户ID生æˆçš„å•æ¡å¾®åšé¡µé¢url post_status å‘布一æ¡å¾®åšä¿¡æ¯ status. å¿…å¡«å‚数, è¦æ›´æ–°çš„å¾®åšä¿¡æ¯ã€‚å¿…é¡»åšURLEncode,ä¿¡æ¯å†…容ä¸è¶…过140个汉å—,为空返回400错误。 in_reply_to_status_id. å¯é€‰å‚数,@ 需è¦å›žå¤çš„å¾®åšä¿¡æ¯ID, 这个å‚æ•°åªæœ‰åœ¨å¾®åšå†…容以 @username 开头æ‰æœ‰æ„义。(å³å°†æŽ¨å‡ºï¼‰ã€‚ lat. å¯é€‰å‚数,纬度,å‘表当å‰å¾®åšæ‰€åœ¨çš„地ç†ä½ç½®ï¼Œæœ‰æ•ˆèŒƒå›´ -90.0到+90.0, +表示北纬。åªæœ‰ç”¨æˆ·è®¾ç½®ä¸geo_enabled=true时候地ç†ä½ç½®æ‰æœ‰æ•ˆã€‚(仅对å—邀请的åˆä½œå¼€å‘者开放) long. å¯é€‰å‚数,ç»åº¦ã€‚有效范围-180.0到+180.0, +表示东ç»ã€‚(仅对å—邀请的åˆä½œå¼€å‘者开放) 如果没有登录或超过å‘布上é™ï¼Œå°†è¿”回403错误. 如果in_reply_to_status_idä¸å˜åœ¨ï¼Œå°†è¿”回500错误. 系统将忽略é‡å¤å‘布的信æ¯ã€‚æ¯æ¬¡å‘布将比较最åŽä¸€æ¡å‘布消æ¯ï¼Œå¦‚æžœä¸€æ ·å°†è¢«å¿½ç•¥ã€‚å› æ¤ç”¨æˆ·ä¸èƒ½è¿žç»æ交相åŒä¿¡æ¯ã€‚ <http://open.t.sina.com.cn/wiki/index.php/Statuses/update> upload_status ä¸Šä¼ å›¾ç‰‡å¹¶å‘布一æ¡å¾®åšä¿¡æ¯ status. å¿…å¡«å‚数, è¦æ›´æ–°çš„å¾®åšä¿¡æ¯ã€‚å¿…é¡»åšURLEncode,ä¿¡æ¯å†…容ä¸è¶…过140个汉å—。支æŒå…¨è§’ã€åŠè§’å—符。 pic. å¿…å¡«å‚数。仅支æŒJPEG,GIF,PNG图片,为空返回400错误。目å‰ä¸Šä¼ 图片大å°é™åˆ¶ä¸º<1M。 lat. å¯é€‰å‚数,纬度,å‘表当å‰å¾®åšæ‰€åœ¨çš„地ç†ä½ç½®ï¼Œæœ‰æ•ˆèŒƒå›´ -90.0到+90.0, +表示北纬。åªæœ‰ç”¨æˆ·è®¾ç½®ä¸geo_enabled=true时候地ç†ä½ç½®æ‰æœ‰æ•ˆã€‚(ä¿ç•™å—段,暂ä¸æ”¯æŒ) long. å¯é€‰å‚数,ç»åº¦ã€‚有效范围-180.0到+180.0, +表示东ç»ã€‚(ä¿ç•™å—段,暂ä¸æ”¯æŒ) 如果使用的Oauth认è¯ï¼Œå›¾ç‰‡å‚æ•°picä¸å‚与ç¾å。 <http://open.t.sina.com.cn/wiki/index.php/Statuses/upload> remove_status åˆ é™¤ä¸€æ¡å¾®åšä¿¡æ¯ id. å¿…é¡»å‚æ•°. è¦åˆ 除的微åšID. <http://open.t.sina.com.cn/wiki/index.php/Statuses/destroy> retweet =head2 repost_status 转å‘一æ¡å¾®åšä¿¡æ¯ï¼ˆå¯åŠ 评论) id å¿…å¡«å‚数, 转å‘çš„å¾®åšID status. å¯é€‰å‚数, æ·»åŠ çš„è½¬å‘ä¿¡æ¯ã€‚å¿…é¡»åšURLEncode,ä¿¡æ¯å†…容ä¸è¶…过140个汉å—。如ä¸å¡«åˆ™è‡ªåŠ¨ç”Ÿæˆç±»ä¼¼â€œè½¬å‘ @author: 原内容â€æ–‡å—。 如果没有登录,将返回403错误. 转å‘çš„å¾®åšä¸å˜åœ¨ï¼Œå°†è¿”回500错误. <http://open.t.sina.com.cn/wiki/index.php/Statuses/repost>. post_comment 对一æ¡å¾®åšä¿¡æ¯è¿›è¡Œè¯„论 id å¿…å¡«å‚数, è¦è¯„论的微åšid comment. å¿…å¡«å‚数, 评论内容。必须åšURLEncode,ä¿¡æ¯å†…容ä¸è¶…过140个汉å—。 <http://open.t.sina.com.cn/wiki/index.php/Statuses/comment> remove_comment åˆ é™¤å½“å‰ç”¨æˆ·çš„å¾®åšè¯„è®ºä¿¡æ¯ id. å¿…é¡»å‚æ•°. è¦åˆ 除的评论ID. 如果评论ä¸å˜åœ¨ï¼Œå°†è¿”回403错误. <http://open.t.sina.com.cn/wiki/index.php/Statuses/comment_destroy> batch_remove_comments 批é‡åˆ 除当å‰ç”¨æˆ·çš„å¾®åšè¯„è®ºä¿¡æ¯ ids 必选å‚数,想è¦åˆ 除评论的id,多个id之间用åŠè§’逗å·åˆ†å‰²ï¼Œæ”¯æŒæœ€å¤š20个。 <http://open.t.sina.com.cn/wiki/index.php/Statuses/comment/destroy_batch > reply_comment 回å¤å¾®åšè¯„è®ºä¿¡æ¯ id å¿…å¡«å‚数, è¦è¯„论的微åšid cid å¿…å¡«å‚数, è¦è¯„论的评论id 如没有或éžæ³•åˆ™ä¸ºå¯¹å¾®åšçš„评论 comment. å¿…å¡«å‚数, 评论内容。必须åšURLEncode,ä¿¡æ¯å†…容ä¸è¶…过140ä¸ªæ±‰å— <http://open.t.sina.com.cn/wiki/index.php/Statuses/reply> hot_users 获å–系统推è用户 category: 分类,å¯é€‰å‚数,返回æŸä¸€ç±»åˆ«çš„推è用户,默认为 default。如果ä¸åœ¨ä¸€ä¸‹åˆ†ç±»ä¸ï¼Œè¿”回空列表: default:人气关注 ent:影视å星 hk_famous:港å°å人 model:模特 cooking:美食&å¥åº· sport:体育å人 finance:商界å人 tech:IT互è”网 singer:æŒæ‰‹ writer:作家 moderator:主æŒäºº medium:媒体总编 stockplayer:炒股高手 <http://open.t.sina.com.cn/wiki/index.php/Users/hot> show_user æ ¹æ®ç”¨æˆ·ID获å–用户资料(授æƒç”¨æˆ·ï¼‰ id. 用户UID或微åšæ˜µç§°ã€‚ user_id. 指定用户UID,主è¦æ˜¯ç”¨æ¥åŒºåˆ†ç”¨æˆ·UIDè·Ÿå¾®åšæ˜µç§°ä¸€æ ·ï¼Œäº§ç”Ÿæ§ä¹‰çš„时候,特别是在用户账å·ä¸ºæ•°å—导致和用户Uidå‘生æ§ä¹‰ screen_name. 指定微åšæ˜µç§°ï¼Œä¸»è¦æ˜¯ç”¨æ¥åŒºåˆ†ç”¨æˆ·UIDè·Ÿå¾®åšæ˜µç§°ä¸€æ ·ï¼Œäº§ç”Ÿæ§ä¹‰çš„时候。 ID或者昵称ä¸å˜åœ¨è¿”回400错误. <http://open.t.sina.com.cn/wiki/index.php/Users/show> friends 获å–当å‰ç”¨æˆ·å…³æ³¨å¯¹è±¡åˆ—表åŠæœ€æ–°ä¸€æ¡å¾®åšä¿¡æ¯ id. 用户UID或微åšæ˜µç§°ã€‚ user_id. 指定用户UID,主è¦æ˜¯ç”¨æ¥åŒºåˆ†ç”¨æˆ·UIDè·Ÿå¾®åšæ˜µç§°ä¸€æ ·ï¼Œäº§ç”Ÿæ§ä¹‰çš„时候,特别是在用户账å·ä¸ºæ•°å—导致和用户Uidå‘生æ§ä¹‰ screen_name. 指定微åšæ˜µç§°ï¼Œä¸»è¦æ˜¯ç”¨æ¥åŒºåˆ†ç”¨æˆ·UIDè·Ÿå¾®åšæ˜µç§°ä¸€æ ·ï¼Œäº§ç”Ÿæ§ä¹‰çš„时候。 cursor. 选填å‚æ•°. å•é¡µåªèƒ½åŒ…å«100个关注列表,为了获å–更多则cursor默认从-1å¼€å§‹ï¼Œé€šè¿‡å¢žåŠ æˆ–å‡å°‘cursoræ¥èŽ·å–更多, 如果没有下一页,则next_cursor返回0 count. å¯é€‰å‚æ•°. æ¯æ¬¡è¿”回的最大记录数(å³é¡µé¢å¤§å°ï¼‰ï¼Œä¸å¤§äºŽ200,默认返回20。 如果没有æä¾›cursorå‚数,将åªè¿”回最å‰é¢çš„100个关注列表。当以Jsonæ–¹å¼è¿”回时,返回结构会ç¨æœ‰ä¸åŒã€‚ <http://open.t.sina.com.cn/wiki/index.php/Statuses/friends> followers 获å–当å‰ç”¨æˆ·ç²‰ä¸åˆ—表åŠæœ€æ–°ä¸€æ¡å¾®åšä¿¡æ¯ id. 用户UID或微åšæ˜µç§°ã€‚ user_id. 指定用户UID,主è¦æ˜¯ç”¨æ¥åŒºåˆ†ç”¨æˆ·UIDè·Ÿå¾®åšæ˜µç§°ä¸€æ ·ï¼Œäº§ç”Ÿæ§ä¹‰çš„时候,特别是在用户账å·ä¸ºæ•°å—导致和用户Uidå‘生æ§ä¹‰ screen_name. 指定微åšæ˜µç§°ï¼Œä¸»è¦æ˜¯ç”¨æ¥åŒºåˆ†ç”¨æˆ·UIDè·Ÿå¾®åšæ˜µç§°ä¸€æ ·ï¼Œäº§ç”Ÿæ§ä¹‰çš„时候。 cursor. 选填å‚æ•°. å•é¡µåªèƒ½åŒ…å«100个关注列表,为了获å–更多则cursor默认从-1å¼€å§‹ï¼Œé€šè¿‡å¢žåŠ æˆ–å‡å°‘cursoræ¥èŽ·å–更多, 如果没有下一页,则next_cursor返回0 count. å¯é€‰å‚æ•°. æ¯æ¬¡è¿”回的最大记录数(å³é¡µé¢å¤§å°ï¼‰ï¼Œä¸å¤§äºŽ200,默认返回20。 如果没有æä¾›cursorå‚数,将åªè¿”回最å‰é¢çš„100个列表. <http://open.t.sina.com.cn/wiki/index.php/Statuses/followers> dm 获å–当å‰ç”¨æˆ·æœ€æ–°ç§ä¿¡åˆ—表 since_id. å¯é€‰å‚æ•°. 返回ID比数值since_id大(比since_id时间晚的)的ç§ä¿¡ã€‚ max_id. å¯é€‰å‚æ•°. 返回IDä¸å¤§äºŽmax_id(时间ä¸æ™šäºŽmax_id)çš„ç§ä¿¡ã€‚ count. å¯é€‰å‚æ•°. æ¯æ¬¡è¿”回的最大记录数(å³é¡µé¢å¤§å°ï¼‰ï¼Œä¸å¤§äºŽ200。 page. å¯é€‰å‚æ•°. 返回结果的页åºå·ã€‚注æ„:有分页é™åˆ¶ã€‚ <http://open.t.sina.com.cn/wiki/index.php/Direct_messages> dm_sent 获å–当å‰ç”¨æˆ·å‘é€çš„最新ç§ä¿¡åˆ—表 since_id. å¯é€‰å‚æ•°. 返回ID比数值since_id大(比since_id时间晚的)的ç§ä¿¡ã€‚ max_id. å¯é€‰å‚æ•°. 返回IDä¸å¤§äºŽmax_id(时间ä¸æ™šäºŽmax_id)çš„ç§ä¿¡ã€‚ count. å¯é€‰å‚æ•°. æ¯æ¬¡è¿”回的最大记录数(å³é¡µé¢å¤§å°ï¼‰ï¼Œä¸å¤§äºŽ200。 page. å¯é€‰å‚æ•°. 返回结果的页åºå·ã€‚注æ„:有分页é™åˆ¶ã€‚ <http://open.t.sina.com.cn/wiki/index.php/Direct_messages/sent> send_dm å‘é€ä¸€æ¡ç§ä¿¡ id: å¿…é¡»å‚æ•°. UID或微åšæ˜µç§°. 为了支æŒæ•°å—çš„å¾®åšæ˜µç§°ï¼Œéœ€é€‰å¡«å†™ä¸‹é¢2个å‚æ•°screen_name或user_id: screen_name: å¾®åšæ˜µç§° user_id: 新浪UID text: å¿…é¡»å‚æ•°. è¦å‘生的消æ¯å†…容,需è¦åšURLEncode,文本大å°å¿…é¡»å°äºŽ300个汉å—. <http://open.t.sina.com.cn/wiki/index.php/Direct_messages/new> remove_dm åˆ é™¤ä¸€æ¡ç§ä¿¡ id. å¿…å¡«å‚数,è¦åˆ 除的ç§ä¿¡ä¸»é”®ID. <http://open.t.sina.com.cn/wiki/index.php/Direct_messages/destroy> batch_remove_dm 批é‡åˆ 除ç§ä¿¡ ids 必选å‚数,想è¦åˆ 除ç§ä¿¡çš„id,多个id之间用åŠè§’逗å·åˆ†å‰²ï¼Œæ”¯æŒæœ€å¤š20个。 <http://open.t.sina.com.cn/wiki/index.php/Direct_messages/destroy_batch> follow 关注æŸç”¨æˆ· id: è¦å…³æ³¨çš„用户UID或微åšæ˜µç§° user_id: è¦å…³æ³¨çš„用户UID,主è¦æ˜¯ç”¨åœ¨åŒºåˆ†ç”¨æˆ·UIDè·Ÿå¾®åšæ˜µç§°ä¸€æ ·ï¼Œäº§ç”Ÿæ§ä¹‰çš„时候。 screen_name: è¦å…³æ³¨çš„å¾®åšæ˜µç§°,主è¦æ˜¯ç”¨åœ¨åŒºåˆ†ç”¨æˆ·UIDè·Ÿå¾®åšæ˜µç§°ä¸€æ ·ï¼Œäº§ç”Ÿæ§ä¹‰çš„时候。 ç›®å‰çš„最多关注2000人,失败则返回一æ¡å—符串的说明。如果已ç»å…³æ³¨äº†æ¤äººï¼Œåˆ™è¿”回http 403的状æ€ã€‚关注ä¸å˜åœ¨çš„ID将返回400。 <http://open.t.sina.com.cn/wiki/index.php/Friendships/create> unfollow å–消关注.æˆåŠŸåˆ™è¿”回被å–消关注人的资料,失败则返回一æ¡å—符串的说明。 id. å¿…å¡«å‚æ•°. è¦å–消关注的用户UID或微åšæ˜µç§° user_id. å¿…å¡«å‚æ•°. è¦å–消关注的用户UID,主è¦æ˜¯ç”¨åœ¨åŒºåˆ†ç”¨æˆ·UIDè·Ÿå¾®åšæ˜µç§°ä¸€æ ·ï¼Œäº§ç”Ÿæ§ä¹‰çš„时候。 screen_name. å¿…å¡«å‚æ•°. è¦å–消的微åšæ˜µç§°,主è¦æ˜¯ç”¨åœ¨åŒºåˆ†ç”¨æˆ·UIDè·Ÿå¾®åšæ˜µç§°ä¸€æ ·ï¼Œäº§ç”Ÿæ§ä¹‰çš„时候。 <http://open.t.sina.com.cn/wiki/index.php/Friendships/destroy> is_followed 获å–两个用户关系的详细情况 以下å‚æ•°å¯ä¸å¡«å†™ï¼Œå¦‚ä¸å¡«ï¼Œåˆ™å–当å‰ç”¨æˆ· source_id. æºç”¨æˆ·UID source_screen_name. æºå¾®åšæ˜µç§° 下é¢å‚数必须选填一个: target_id. è¦åˆ¤æ–的目的用户UID target_screen_name. è¦åˆ¤æ–的目的微åšæ˜µç§° 如果æºç”¨æˆ·æˆ–目的用户ä¸å˜åœ¨ï¼Œå°†è¿”回httpçš„400错误. 返回的blocking表示source_id用户是å¦å¯¹target_idåŠ é»‘åå•ï¼Œåªå¯¹source_id是当å‰ç”¨æˆ·æœ‰æ•ˆï¼Œå³åªèƒ½çœ‹åˆ°è‡ªå·±çš„阻æ¢è®¾ç½® (blockingå议暂ä¸æ”¯æŒè¿”回) <http://open.t.sina.com.cn/wiki/index.php/Friendships/show> get_friends_id_list 获å–用户关注对象uid列表 id. 用户UID或微åšæ˜µç§°ã€‚ user_id. 指定用户UID,主è¦æ˜¯ç”¨æ¥åŒºåˆ†ç”¨æˆ·UIDè·Ÿå¾®åšæ˜µç§°ä¸€æ ·ï¼Œäº§ç”Ÿæ§ä¹‰çš„时候,特别是在用户账å·ä¸ºæ•°å—导致和用户Uidå‘生æ§ä¹‰ screen_name. 指定微åšæ˜µç§°ï¼Œä¸»è¦æ˜¯ç”¨æ¥åŒºåˆ†ç”¨æˆ·UIDè·Ÿå¾®åšæ˜µç§°ä¸€æ ·ï¼Œäº§ç”Ÿæ§ä¹‰çš„时候。 cursor. 选填å‚æ•°. å•é¡µåªèƒ½åŒ…å«100个关注列表,为了获å–更多则cursor默认从-1å¼€å§‹ï¼Œé€šè¿‡å¢žåŠ æˆ–å‡å°‘cursoræ¥èŽ·å–更多, 如果没有下一页,则next_cursor返回0 count. å¯é€‰å‚æ•°. æ¯æ¬¡è¿”回的最大记录数(å³é¡µé¢å¤§å°ï¼‰ï¼Œä¸å¤§äºŽ200,默认返回20。 如果没有æä¾›cursorå‚数,将åªè¿”回最å‰é¢çš„5000个关注id <http://open.t.sina.com.cn/wiki/index.php/Friends/ids> get_followers_id_list 获å–用户粉ä¸å¯¹è±¡uid列表 id. 用户UID或微åšæ˜µç§°ã€‚ user_id. 指定用户UID,主è¦æ˜¯ç”¨æ¥åŒºåˆ†ç”¨æˆ·UIDè·Ÿå¾®åšæ˜µç§°ä¸€æ ·ï¼Œäº§ç”Ÿæ§ä¹‰çš„时候,特别是在用户账å·ä¸ºæ•°å—导致和用户Uidå‘生æ§ä¹‰ screen_name. 指定微åšæ˜µç§°ï¼Œä¸»è¦æ˜¯ç”¨æ¥åŒºåˆ†ç”¨æˆ·UIDè·Ÿå¾®åšæ˜µç§°ä¸€æ ·ï¼Œäº§ç”Ÿæ§ä¹‰çš„时候。 cursor. 选填å‚æ•°. å•é¡µåªèƒ½åŒ…å«100个关注列表,为了获å–更多则cursor默认从-1å¼€å§‹ï¼Œé€šè¿‡å¢žåŠ æˆ–å‡å°‘cursoræ¥èŽ·å–更多, 如果没有下一页,则next_cursor返回0 count. å¯é€‰å‚æ•°. æ¯æ¬¡è¿”回的最大记录数(å³é¡µé¢å¤§å°ï¼‰ï¼Œä¸å¤§äºŽ200,默认返回20。 如果没有æä¾›cursorå‚数,将åªè¿”回最å‰é¢çš„5000个粉ä¸id <http://open.t.sina.com.cn/wiki/index.php/Followers/ids> update_privacy 设置éšç§ä¿¡æ¯ comment: è°å¯ä»¥è¯„论æ¤è´¦å·çš„微薄。 0:所有人 1:我关注的人 默认为0 message:è°å¯ä»¥ç»™æ¤è´¦å·å‘ç§ä¿¡ã€‚0:所有人 1:我关注的人 默认为1 realname 是å¦å…许别人通过真实姓åæœç´¢åˆ°æˆ‘,值---0å…许,1ä¸å…许,默认值1 geo å‘布微åšï¼Œæ˜¯å¦å…许微åšä¿å˜å¹¶æ˜¾ç¤ºæ‰€å¤„的地ç†ä½ç½®ä¿¡æ¯ã€‚值—0å…许,1ä¸å…许,默认值0 badge å‹‹ç« å±•çŽ°çŠ¶æ€ï¼Œå€¼â€”1ç§å¯†çŠ¶æ€ï¼Œ0公开状æ€ï¼Œé»˜è®¤å€¼0 <http://open.t.sina.com.cn/wiki/index.php/Account/update_privacy> get_privacy 获å–éšç§ä¿¡æ¯ <http://open.t.sina.com.cn/wiki/index.php/Account/get_privacy> block_user å°†æŸç”¨æˆ·åŠ 入黑åå• å¿…é€‰å‚数(至少选一个): user_id:è¦åŠ 入黑åå•çš„用户ID。 screen_name:è¦åŠ 入黑åå•çš„用户微åšæ˜µç§°ï¼Œå¯é€‰ã€‚ user_id或screen_nameè‹¥ä¸å˜åœ¨è¿”回400 <http://open.t.sina.com.cn/wiki/index.php/Blocks/create> unblock_user å°†æŸç”¨æˆ·ç§»å‡ºé»‘åå• å¿…é€‰å‚数(至少选一个): user_id:è¦åˆ 除黑åå•çš„用户ID screen_name:è¦åˆ 除黑åå•çš„用户昵称 <http://open.t.sina.com.cn/wiki/index.php/Blocks/destroy> is_blocked æŸç”¨æˆ·æ˜¯å¦æ˜¯é»‘åå•ç”¨æˆ· 必选å‚数(至少选一个): user_id:è¦æ£€æŸ¥çš„用户ID screen_name:è¦æ£€æŸ¥çš„用户昵称 <http://open.t.sina.com.cn/wiki/index.php/Blocks/exists> blocking 列出黑åå•ç”¨æˆ·(输出用户详细信æ¯) page. 页ç ,å¯é€‰ã€‚. count. 一页大å°ï¼Œå¯é€‰ã€‚. <http://open.t.sina.com.cn/wiki/index.php/Blocks/blocking> blocking_id_list 列出分页黑åå•ç”¨æˆ·ï¼ˆåªè¾“出id) page. 页ç ,å¯é€‰ã€‚. count. 一页大å°ï¼Œå¯é€‰ã€‚. <http://open.t.sina.com.cn/wiki/index.php/Blocks/blocking/ids> tags è¿”å›žæŒ‡å®šç”¨æˆ·çš„æ ‡ç¾åˆ—表 user_id: å¿…å¡«å‚数,查询用户的ID count: å¯é€‰å‚æ•°. æ¯æ¬¡è¿”回的最大记录数(å³é¡µé¢å¤§å°ï¼‰ï¼Œä¸å¤§äºŽ200,默认为20。 page: å¯é€‰å‚æ•°. 返回结果的页åºå·ã€‚注æ„:有分页é™åˆ¶ã€‚ <http://open.t.sina.com.cn/wiki/index.php/Tags> add_tag æ·»åŠ ç”¨æˆ·æ ‡ç¾ tags: æ ‡ç¾ï¼Œå¿…å¡«å‚æ•°ï¼Œå¤šä¸ªæ ‡ç¾ä¹‹é—´ç”¨é€—å·é—´éš” <http://open.t.sina.com.cn/wiki/index.php/Tags/create> tag_suggestions è¿”å›žç”¨æˆ·æ„Ÿå…´è¶£çš„æ ‡ç¾ page: å¯é€‰å‚数,页ç ,默认为1 count: å¯é€‰å‚数,分页大å°ï¼Œé»˜è®¤ä¸º10 <http://open.t.sina.com.cn/wiki/index.php/Tags/suggestions> remove_tag åˆ é™¤æ ‡ç¾ tag_idï¼šæ ‡ç¾ID,必填å‚æ•° <http://open.t.sina.com.cn/wiki/index.php/Tags/destroy> batch_remove_tags 批é‡åˆ é™¤æ ‡ç¾ ids:必选å‚数,è¦åˆ 除的tag id,多个id用åŠè§’逗å·åˆ†å‰²ï¼Œæœ€å¤š20个。 <http://open.t.sina.com.cn/wiki/index.php/Tags/destroy_batch> verify_credentials 验è¯å½“å‰ç”¨æˆ·èº«ä»½æ˜¯å¦åˆæ³•. 如果用户新浪通行è¯èº«ä»½éªŒè¯æˆåŠŸä¸”用户已ç»å¼€é€šå¾®åšåˆ™è¿”回 http状æ€ä¸º 200;如果是ä¸åˆ™è¿”回401的状æ€å’Œé”™è¯¯ä¿¡æ¯ã€‚æ¤æ–¹æ³•ç”¨äº†åˆ¤æ–用户身份是å¦åˆæ³•ä¸”å·²ç»å¼€é€šå¾®åšã€‚ <http://open.t.sina.com.cn/wiki/index.php/Account/verify_credentials> rate_limit_status 获å–当å‰ç”¨æˆ·API访问频率é™åˆ¶ <http://open.t.sina.com.cn/wiki/index.php/Account/rate_limit_status> end_session 当å‰ç”¨æˆ·é€€å‡ºç™»å½•.清除已验è¯ç”¨æˆ·çš„session,退出登录,并将cookie设为null。主è¦ç”¨äºŽwidgetç‰web应用场åˆã€‚ <http://open.t.sina.com.cn/wiki/index.php/Account/end_session> update_profile 更改资料. 必须有一下å‚æ•°ä¸çš„一个或多个,å‚数值为å—符串. 进一æ¥çš„é™åˆ¶ï¼Œè¯·å‚阅下é¢çš„å„个å‚æ•°æè¿°. name. 昵称,å¯é€‰å‚æ•°.ä¸è¶…过20ä¸ªæ±‰å— gender 性别,å¯é€‰å‚æ•°. m,男,f,女。 province å¯é€‰å‚æ•°. å‚考çœä»½åŸŽå¸‚ç¼–ç 表 city å¯é€‰å‚æ•°. å‚考çœä»½åŸŽå¸‚ç¼–ç 表,1000为ä¸é™ description. å¯é€‰å‚æ•°. ä¸è¶…过160个汉å—. <http://open.t.sina.com.cn/wiki/index.php/Account/update_profile> update_profile_image æ›´æ–°ç”¨æˆ·å¤´åƒ image.å¿…é¡»å‚æ•°. 必须为å°äºŽ700K的有效的GIF, JPG, 或 PNG 图片. 如果图片大于500åƒç´ 将按比例缩放。 <http://open.t.sina.com.cn/wiki/index.php/Account/update_profile_image> favorites 获å–当å‰ç”¨æˆ·çš„收è—列表 page: å¯é€‰å‚æ•°. 返回结果的页åºå·ã€‚注æ„:有分页é™åˆ¶ã€‚ <http://open.t.sina.com.cn/wiki/index.php/Favorites> add_favorite æ·»åŠ æ”¶è—. id å¿…å¡«å‚数, è¦æ”¶è—çš„å¾®åšid <http://open.t.sina.com.cn/wiki/index.php/Favorites/create> remove_favorite åˆ é™¤å½“å‰ç”¨æˆ·æ”¶è—çš„å¾®åšä¿¡æ¯ id. å¿…é¡»å‚æ•°. è¦åˆ 除的收è—å¾®åšä¿¡æ¯ID. <http://open.t.sina.com.cn/wiki/index.php/Favorites/destroy> batch_remove_favorites 批é‡åˆ 除收è—çš„å¾®åšä¿¡æ¯ ids 必选å‚数,想è¦åˆ 除收è—å¾®åšçš„id,多个id之间用åŠè§’逗å·åˆ†å‰²ï¼Œæ”¯æŒæœ€å¤š20个。 <http://open.t.sina.com.cn/wiki/index.php/Favorites/destroy_batch> DEVELOPERS The latest code for this module can be found at <http://github.com/nightsailer/net-sinaweibo.git> Author blog: (Chinese) <http://nightsailer.com/> SUPPORT You can find documentation for this module with the perldoc command. perldoc Net::SinaWeibo You can also look for information at: Issues tracker: <http://github.com/nightsailer/net-sinaweibo/issues> SEE ALSO SinaWeibo Developer Site <http://open.t.sina.com.cn/wiki/> OAuth <http://oauth.net/> OAuth::Lite Net::OAuth AUTHOR Pan Fan(nightsailer) <nightsailer@gmail.com> COPYRIGHT AND LICENSE This software is copyright (c) 2010 by Pan Fan(nightsailer). This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.