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 >
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 >