根据UID获取多个用户的资料

接口说明

根据UID获取多个用户的资料

访问权限

请求Access Token时如果没有传递scope参数,则只能获取到用户的基本资料(返回字段说明中标明basic的字段,其中一些字段需要在接口调用时设置fields才能获取)。

如需获得用户更多资料,需设置扩展权限,获取当前用户更多资料,请设置user_类权限;获取好友更多资料,请设置friends_类权限。详细权限名称请参考 返回字段说明权限列表

请求URL地址

OAuth1.0a access token方式:https://api.kaixin001.com/users/show.(json|xml)
OAuth2.0 access token方式:https://api.kaixin001.com/users/show.(json|xml)
session key方式:https://api.kaixin001.com/users/show.(json|xml)

支持格式

XML/JSON

是否使用HTTPS连接

OAuth1.0a access token方式:否
OAuth2.0 access token方式:是
session key方式:是

HTTP请求方式

GET

是否需要登录

TRUE

注意事项

为了保护用户隐私,只有用户设置了公开或对好友设置了公开的数据才会返回。

如果请求数据不合法,或者超过请求频率限制,返回HTTP状态码400。

如果没有进行身份验证,返回HTTP状态码401。

如果没有权限访问对应的资源,返回HTTP状态码403。

如果请求的资源不存在,返回HTTP状态码404。

如果服务器内部错误,返回HTTP状态码500。

如果接口API关闭或正在升级,返回HTTP状态码502。

调用示例

http://api.kaixin001.com/users/show.json?oauth_consumer_key=614387522049a16db8b17635ec558189&oauth_nonce=b54da9c5ab5fcbb0763fad0a35fd7f14&oauth_signature=0DSxswXzykZ5QQBexWYPaE%2BlagM%3D&oauth_signature_method=HMAC-SHA1&oauth_timestamp=1310104648&oauth_token=f1988aeb1c7114821d9d7966bc8992&oauth_version=1.0&uids=13745%2C13749

请求参数说明

api参数

uids:用户ID,可以设置多个,以半角逗号分隔。如:123456,220993,最多不能超过50个。

fields:允许用户自定义返回字段,多个属性之间用英文半角逗号作为分隔符。
用户的所有属性:uid, name, gender, hometown, city, status, logo120, logo50, birthday, bodyform, blood, marriage, trainwith, interest, favbook, favmovie, favtv, idol, motto, wishlist, intro, education, schooltype, school, class, year, career, company, dept, beginyear, beginmonth, endyear, endmonth, isStar, online
用户的基本属性:uid, name, gender, logo50
当fields字段为空的时候只返回用户的基本属性。

OAuth1.0验证参数

oauth_token:授权的access token。

oauth_consumer_key:应用的App Key。

oauth_signature_method:签名方法,暂只支持HMAC-SHA1。

oauth_signature:签名值,密钥为oauth_comsumer_secret和oauth_token_secret以&作为分隔符拼起来。

oauth_timestamp:时间戳, 其值是距1970 00:00:00 GMT的秒数。

oauth_nonce:单次值,随机生成的32位字符串,防止重放攻击(每次请求必须不同)。

oauth_version:(可选) 版本号,如果有必须为 1.0。

OAuth2.0验证参数

access_token:授权的access token。

调试工具地址

返回结果示例

XML示例:

<?xml version="1.0" encoding="UTF-8"?>
<user>
<uid>46765</uid>
<name>刘一</name>
<gender>0</gender>
<hometown>北京</hometown>
<city>北京</city>
<status>2</status>
<logo120>http://pic1.kaixin001.com.cn/logo/4/67/120_46765_2.jpg</logo120>
<logo50>http: //pic1.kaixin001.com.cn/logo/4/67/50_46765_2.jpg</logo50>
<birthday>80后1月1日</birthday>
<bodyform>0</bodyform>
<blood>1</blood>
<marriage>1</marriage>
<trainwith>迈克尔 乔丹</trainwith>
<interest>打篮球</interest>
<favbook>武 侠小说</favbook>
<favmovie>美国大片</favmovie>
<favtv>美 剧</favtv>
<idol>迈克尔 乔丹</idol>
<motto>成功没有捷径</motto>
<wishlist>买套房子</wishlist>
<intro>我是一个纯粹的人,一个高尚的人,一个脱离低级趣味的人..</intro>
<education>
<college>
<schooltype>0</schooltype>
<school>北京大学</school>
<class>软件与微电子学院 11</class>
<year>2011</year>
</college>
</education>
<career>
<job>
<company>开心网</company>
<dept>技术</dept>
<beginyear>2011</beginyear>
<beginmonth>01</beginmonth>
<endyear>2011</endyear>
<endmonth>12</endmonth>
</job>
</career>
<isStar>0</isStar>
</user>

JSON示例:

{
    "users": [{
        "uid": "46765",
        "name": "刘一",
        "gender": "0",
        "hometown": "北京",
        "city": "北京",
        "status": "2",
        "logo120": "http://pic1.kaixin001.com.cn/logo/4/67/120_46765_2.jpg",
        "logo50": "http://pic1.kaixin001.com.cn/logo/4/67/50_46765_2.jpg",
        "birthday": "80后1月1日",
        "blood": "1",
        "marriage": "1",
        "trainwith": "迈克尔 乔丹",
        "interest": "打篮球",
        "favbook": "武侠小说",
        "favmovie": "美国大片",
        "favtv": "美剧",
        "idol": "迈克尔 乔丹",
        "motto": "成功没有捷径",
        "wishlist": "买套房子",
        "intro": "我是一个纯粹的人,一个高尚的人,一个脱离低级趣味的人..",
        "education": [{
            "schooltype": "0",
            "school": "北京大学",
            "class": "软件与微电子学院 11",
            "year": "2011"
        }],
        "career": [{
            "company": "开心网",
            "dept": "技术",
            "beginyear": "2011",
            "beginmonth": "01",
            "endyear": "2011",
            "endmonth": "12"
        }],
        "online": "0",
        "isStar": "0"
    }, {
        "uid": "13749",
        "name": "剑峰丙",
        "gender": "0",
        "hometown": "厦门",
        "city": "北京",
        "status": "0",
        "logo120": "http://img.kaixin001.com.cn/i/120_0_0.gif",
        "logo50": "http://img.kaixin001.com.cn/i/50_0_0.gif",
        "birthday": "1986年11月27日",
        "blood": "0",
        "marriage": "2",
        "trainwith": "女生,喜欢运动的",
        "interest": "游泳,打球",
        "favbook": "",
        "favmovie": "倩女幽魂",
        "favtv": "金婚,美好世界",
        "idol": "林依晨,王力宏",
        "motto": "什么都没有",
        "wishlist": "想干嘛干嘛",
        "intro": "一个拉拉拉拉的人",
        "education": [{
            "schooltype": "1",
            "school": "北京市第二十四中学",
            "class": "21",
            "year": "2010"
        }, {
            "schooltype": "0",
            "school": "北京大学",
            "class": "EECS 21",
            "year": "2009"
        }],
        "career": [{
            "company": "开心网",
            "dept": "技术",
            "beginyear": "2011",
            "beginmonth": "02",
            "endyear": "",
            "endmonth": ""
        }, {
            "company": "搜狐",
            "dept": "技术",
            "beginyear": "1994",
            "beginmonth": "10",
            "endyear": "2001",
            "endmonth": "11"
        }, {
            "company": "新浪",
            "dept": "开发工程",
            "beginyear": "1993",
            "beginmonth": "03",
            "endyear": "1997",
            "endmonth": "05"
        }],
        "isStar": "0"
    }]
}

返回结果字段说明

字段说明当前用户资料权限好友资料权限类型
uid用户IDbasicbasicstring
name用户名basicbasicstring
gender性别
0:男
1:女
basicbasicstring
hometown家乡basicbasicstring
city现居住地basicbasicstring
status状态
0:其它
1:学生
2:已工作
basicbasicstring
logo120头像120 x 120basicbasicstring
logo50头像50 x 50basicbasicstring
birthday生日user_birthdayfriends_birthdaystring
bodyform体型
0:保密
1:苗条
2:匀称
3:健壮
4:高大
5:小巧
6:丰满
7:高挑
8:较胖
9:较瘦
10:运动型
user_bodyformfriends_bodyformstring
blood血型
0:没有填写
1:O型血
2:A型血
3:B型血
4:AB型血
5:稀有血型
user_bloodfriends_bloodstring
marriage婚姻状态
0:没有填写
1:单身
2:恋爱中
3:订婚
4:已婚
5:离异
user_marriagefriends_marriagestring
trainwith希望结交user_introfriends_introstring
interest兴趣爱好user_introfriends_introstring
favbook喜欢的书籍user_introfriends_introstring
favmovie喜欢的电影user_introfriends_introstring
favtv喜欢的电视剧user_introfriends_introstring
idol偶像user_introfriends_introstring
motto座右铭user_introfriends_introstring
wishlist愿望列表user_introfriends_introstring
intro介绍user_introfriends_introstring
education教育经历user_educationfriends_educationarray
 schooltype学校类型user_educationfriends_educationstring
 school学校user_educationfriends_educationstring
 class班级user_educationfriends_educationstring
 year入学年份user_educationfriends_educationstring
career工作经历user_careerfriends_careerarray
 company公司名称user_careerfriends_careerstring
 dept所在部门user_careerfriends_careerstring
 beginyear当前工作开始年份user_careerfriends_careerstring
 beginmonth当前工作开始月份user_careerfriends_careerstring
 ndyear当前工作结束年份user_careerfriends_careerstring
 endmonth当前工作结束月份user_careerfriends_careerstring
isStar是否公共主页
0:否
1:是
basicbasicstring
pinyin用户的姓名拼音basicbasicstring
online用户是否在线
0:不在线
1:在线
user_onlinefriends_onlinestring

错误代码释义