获取当前登录用户的资料

接口说明

获取当前登录用户的资料

访问权限

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

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

请求URL地址

OAuth1.0a access token方式:http://api.kaixin001.com/users/me.(json|xml)
OAuth2.0 access token方式:https://api.kaixin001.com/users/me.(json|xml)
session key方式:https://api.kaixin001.com/users/me.(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。

调用示例

OAuth1.0a:

http://api.kaixin001.com/users/me.json?oauth_consumer_key=69938658024667b0f57dc661d91a707e&oauth_nonce=8a6bf95de0b306a4456dfa7855f514ee&oauth_signature=gtzVil5%2BWZJmKYydm%2F9anzxaqhs%3D&oauth_signature_method=HMAC-SHA1&oauth_timestamp=1310108207&oauth_token=419e5493e1dcd7920cec1df39a868a&oauth_version=1.0

OAuth2.0:

https://api.kaixin001.com/users/me.json?access_token=12932845_fb84eae5330e0097f24465813a6a18f9
api参数

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, pinyin, online
用户的基本属性:uid, name, gender, logo50
当fields字段为空的时候只返回用户的基本属性。

OAuth1.0验证参数

oauth_token: 登录用户的token,用于验证该调用请求是否为当前用户发出的。
oauth_consumer_key:应用的API 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示例:

{
    "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日",
    "bodyform": "0",
    "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"
    }],
    "isStar": "0"
}

返回结果字段说明

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

错误代码释义