users/show

按用户UID或昵称返回用户资料，同时也将返回用户的最新发布的微博。

URL

http://api.t.sina.com.cn/users/show.format

格式

xml, json

HTTP请求方式

GET

是否需要身份验证

false

请求数限制

true

请求参数

• id. 用户UID或微博昵称。

o 示例: http://api.t.sina.com.cn/users/show/12345.json or http://api.t.sina.com.cn/users/show/bob.xml

• user_id. 指定用户UID,主要是用来区分用户UID跟微博昵称一样，产生歧义的时候，特别是在用户账号为数字导致和用户Uid发生歧义。

o 示例: http://api.t.sina.com.cn/users/show.xml?user_id=1401881

• screen_name. 指定微博昵称，主要是用来区分用户UID跟微博昵称一样，产生歧义的时候。

o 示例: http://api.t.sina.com.cn/users/show.xml?screen_name=101010

使用说明

• ID或者昵称不存在返回400错误
• 为了保护用户隐私，只有用户设置了公开或对粉丝设置了公开的数据才会返回。

返回结果

XML

<?xml version="1.0" encoding="UTF-8"?> <user>

 <id>1266321801</id>
 <screen_name>姚晨</screen_name>
 <name>姚晨</name>
 <province>11</province>
 <city>5</city>
 <location>北京 朝阳区</location>
 <description>一颗很逊的卤蛋。</description>
 <url>http://blog.sina.com.cn/yaochen</url>
 <profile_image_url>http://tp2.sinaimg.cn/1266321801/50/1283203855</profile_image_url>
 <domain>yaochen</domain>
 <gender>f</gender>
 <followers_count>2825298</followers_count>
 <friends_count>562</friends_count>
 <statuses_count>2160</statuses_count>
 <favourites_count>10</favourites_count>
 <created_at>Fri Aug 28 00:00:00 +0800 2009</created_at>
 <following>false</following>
 <verified>true</verified>
 <allow_all_act_msg>false</allow_all_act_msg>
 <geo_enabled>false</geo_enabled>
 <status>
   <created_at>Mon Sep 13 14:25:38 +0800 2010</created_at>
   <id>2585938903</id>
   <text>今日又和@陈奕利 导演一起吃饭，他说：上次我们吃饭被偷拍的那个绯闻让我很生气。我：是啊，我也很生气。陈导：不是的，我有个朋友说，这消息一看就是假的，姚晨怎么可能看上你呢？我有那么差吗？我太生气了！我：呃，导演，你节哀顺便...</text>
   <source>
     <a href="http://news.sina.com.cn/wap/wbclient.html#3">iPhone客户端</a>
   </source>
   <favorited>false</favorited>
   <truncated>false</truncated>
   <geo/>
   <in_reply_to_status_id/>
   <in_reply_to_user_id/>
   <in_reply_to_screen_name/>
   <thumbnail_pic>http://ss4.sinaimg.cn/thumbnail/4b7a89894901e2a285b43&690</thumbnail_pic>
   <bmiddle_pic>http://ss4.sinaimg.cn/bmiddle/4b7a89894901e2a285b43&690</bmiddle_pic>
   <original_pic>http://ss4.sinaimg.cn/orignal/4b7a89894901e2a285b43&690</original_pic>
 </status>

</user>

JSON

{

  "id":1266321801,
  "screen_name":"姚晨",
  "name":"姚晨",
  "province":"11",
  "city":"5",
  "location":"北京 朝阳区",
  "description":"一颗很逊的卤蛋。",
  "url":"http://blog.sina.com.cn/yaochen",
  "profile_image_url":"http://tp2.sinaimg.cn/1266321801/50/1283203855",
  "domain":"yaochen",
  "gender":"f",
  "followers_count":2825298,
  "friends_count":562,
  "statuses_count":2160,
  "favourites_count":10,
  "created_at":"Fri Aug 28 00:00:00 +0800 2009",
  "following":false,
  "allow_all_act_msg":false,
  "geo_enabled":false,
  "verified":true,
  "status":{
     "created_at":"Mon Sep 13 14:25:38 +0800 2010",
     "id":2585938903,
     "text":"今日又和@陈奕利 导演一起吃饭，他说：上次我们吃饭被偷拍的那个绯闻让我很生气。我：是啊，我也很生气。陈导：不是的，我有个朋友说，这消息一看就是假的，姚晨怎么可能看上你呢？我有那么差吗？我太生气了！我：呃，导演，你节哀顺便...",
     "source":"<a href=\"http://news.sina.com.cn/wap/wbclient.html#3\" rel=\"nofollow\">iPhone客户端</a>",
     "favorited":false,
     "truncated":false,
     "in_reply_to_status_id":"",
     "in_reply_to_user_id":"",
     "in_reply_to_screen_name":"",
     "thumbnail_pic":"http://ss4.sinaimg.cn/thumbnail/4b7a89894901e2a285b43&690",
     "bmiddle_pic":"http://ss4.sinaimg.cn/bmiddle/4b7a89894901e2a285b43&690",
     "original_pic":"http://ss4.sinaimg.cn/orignal/4b7a89894901e2a285b43&690",
     "geo":null
  }

}

字段说明 - user

• id: 用户UID
• screen_name: 微博昵称
• name: 友好显示名称，同微博昵称
• province: 省份编码（参考省份编码表）
• city: 城市编码（参考城市编码表）
• location：地址
• description: 个人描述
• url: 用户博客地址
• profile_image_url: 自定义图像
• domain: 用户个性化URL
• gender: 性别,m--男，f--女,n--未知
• followers_count: 粉丝数
• friends_count: 关注数
• statuses_count: 微博数
• favourites_count: 收藏数
• created_at: 创建时间
• following: 是否已关注(此特性暂不支持)
• verified: 加V标示，是否微博认证用户

使用示例

• xml:

curl -u uid:password "http://api.t.sina.com.cn/users/show.xml?screen_name=timyang&source=appkey"

• json:

curl -u uid:password http://api.t.sina.com.cn/users/show/11054.json or http://api.t.sina.com.cn/users/show/11054.xml?source=appkey

Java示例

请从 微博SDK开发包下载 下载Java SDK
代码示例如下:

package weibo4j.examples;

import weibo4j.User;
import weibo4j.Weibo;
import weibo4j.WeiboException; 

public class GetUserInfo {

	/**
	 * 根据用户ID获取用户资料（授权用户） 
	 * @param args
	 */
	public static void main(String[] args) {
		System.setProperty("weibo4j.oauth.consumerKey", Weibo.CONSUMER_KEY);
    	System.setProperty("weibo4j.oauth.consumerSecret", Weibo.CONSUMER_SECRET);
		try {
			User user = getWeibo(true,args).showUser(args[2]);
			System.out.println(user.toString());
		} catch (WeiboException e) {
			e.printStackTrace();
		}
	}
	
	private static Weibo getWeibo(boolean isOauth,String[] args) {
		Weibo weibo = new Weibo();
		if(isOauth) {//oauth验证方式 args[0]:访问的token；args[1]:访问的密匙
			weibo.setToken(args[0], args[1]);
		}else {//用户登录方式
    		weibo.setUserId(args[0]);//用户名/ID
   		weibo.setPassword(args[1]);//密码
		}
		return weibo;
	}
}

PHP示例

请从 微博SDK开发包下载 处下载PHP SDK（支持OAuth验证之版本）
代码示例如下:

//users/show
//根据用户ID获取用户资料（授权用户）
$c = new WeiboClient( WB_AKEY , 
                      WB_SKEY , 
                      $_SESSION['last_key']['oauth_token'] , 
                      $_SESSION['last_key']['oauth_token_secret']  );
//用户ID
$u_id = "u_id";
$msg = $c->show_user($u_id);
if ($msg === false || $msg === null){
	echo "Error occured";
	return false;
}
if (isset($msg['error_code']) && isset($msg['error'])){
	echo ('Error_code: '.$msg['error_code'].';  Error: '.$msg['error'] );
	return false;
}
echo($msg['id'].' : '.$msg['name'].'  '.$msg['created_at']);