users/show 根据用户ID获取用户资料（授权用户）
users/show
按用户ID或昵称返回用户资料以及用户的最新发布的一条微博消息。
URL
http://api.t.sina.com.cn/users/show.(json|xml)
支持格式
XML/JSON
HTTP请求方式
GET
是否需要登录
true
关于授权机制，参见授权机制声明
请求数限制
true
关于请求数限制，参见接口访问权限说明
请求参数
必选 类型及范围 说明
source true string 申请应用时分配的AppKey，调用接口时候代表应用的唯一身份。（采用OAuth授权方式不需要此参数）
:id false int64/string 用户ID(int64)或者昵称(string)。该参数为一个REST风格参数。调用示例见注意事项
user_id false int64 用户ID，主要是用来区分用户ID跟微博昵称。当微博昵称为数字导致和用户ID产生歧义，特别是当微博昵称和用户ID一样的时候，建议使用该参数
screen_name false string 微博昵称，主要是用来区分用户UID跟微博昵称，当二者一样而产生歧义的时候，建议使用该参数
:id、user_id、screen_name这三个参数三者至少要提供一个
使用示例如下：
http://api.t.sina.com.cn/users/show/11051.xml?source=appkey
http://api.t.sina.com.cn/users/show/timyang.json?source=appkey
字段说明 - 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标示，是否微博认证用户
字段说明 - status
created_at: 创建时间
id: 微博ID
text: 微博信息内容
source: 微博来源
favorited: 是否已收藏
truncated: 是否被截断
in_reply_to_status_id: 回复ID
in_reply_to_user_id: 回复人UID
in_reply_to_screen_name: 回复人昵称
thumbnail_pic: 缩略图
bmiddle_pic: 中型图片
original_pic：原始图片
user: 作者信息
retweeted_status: 转发的博文，内容为status，如果不是转发，则没有此字段
JS和HTML代码
<html>
<head>
<script src="JS/jquery-1.4.2.min.js" language="javascript" type="text/javascript">
</script>
<script language="javascript" type="text/javascript">
$(function () {
$("#btnGetUserDat").click(function () {
GetFriends($("#txtAppKey").val(), $("#txtUserId").val(), $("#txtScrName").val());
});
});
//验证是否为空
function IsNullOrEmpty(dataStr) {
if (dataStr == null || dataStr == "" || dataStr == undefined || dataStr == "undefined") {
return true;
} else {
return false;
}
}
//获取API接口数据
function GetFriends(appkey, userid_id, screen_name) {
// var url = "http://api.t.sina.com.cn/users/show.json?source=" + appkey + "&user_id=" + userid_id;
$("#divUserData").empty();
if (IsNullOrEmpty(appkey)) {
alert("很抱歉，appkey不能为空。");
return;
}
if (IsNullOrEmpty(userid_id) && IsNullOrEmpty(screen_name)) {
alert("很抱歉，用户ID和微博昵称最少填写一个。");
return;
}
var urlData = "source=" + appkey;
if (!IsNullOrEmpty(userid_id)) {
urlData += "&user_id=" + userid_id
} else if (!IsNullOrEmpty(screen_name)) {
urlData += "&screen_name=" + screen_name;
}
var url = "http://api.t.sina.com.cn/users/show.json?" + urlData;
// jQuery
$.ajax({
url: url, // url,
type: "GET",
dataType: "json",
cache: false,
success: function (data) {
if (data != null && data != null && data != undefined) {
var msg = data;
var sex = "未知";
if (data.gender == "m") {
sex = "男";
}
else if (data.gender == "f") {
sex = "女";
}
var html = "<ul>"
+ "<li>微博昵称:" + data.screen_name + "</li>"
+ "<li>同微博昵称:" + data.name + "</li>"
+ "<li>省份编码:" + data.province + "</li>"
+ "<li>城市编码:" + data.city + "</li>"
+ "<li>地址:" + data.location + "</li>"
+ "<li>个人描述:" + data.description + "</li>"
+ "<li>用户博客地址:" + data.url + "</li>"
+ "<li>性别:" + sex + "</li>"
+ "<li>微博数：" + data.statuses_count + "</li>"
+ "<li>收藏数：" + data.favourites_count + "</li>"
+ "<li>创建时间：" + data.created_at + "</li>"
+ "</ul>";
$("#divUserData").html(html);
} else {
$("#divUserData").html("用户不存在");
}
}
});
}
</script>
</head>
<body>
appKey：<input id="txtAppKey" value="3476523072" />
用户ID：<input id="txtUserId" value="" />
微博昵称：<input id="txtScrName" value="微博账号ID" />
<button type="button" id="btnGetUserDat">获取用户信息</button>
<div id="divUserData">
</div>
</body>
</html>
