User/show

出自天涯开放平台资源

跳转到: 导航, 搜索

目录

users/show

返回指定id或者username用户信息

URL

http://open.tianya.cn/api/user/show.php

支持格式

XML/JSON

HTTP请求方式

GET/POST

是否需要登录

true
关于授权机制,参见OAuth相关说明

请求参数

  必选 类型及范围 说明
appkey true string 申请应用时分配的appkey,调用接口时候代表应用的唯一身份
oauth_token true string 授权成功后所获得的 oauth_token
oauth_token_secret true string 授权成功后所获得的oauth_token_secret
timestamp true string 请求时候产生的时间戳time()
tempkey true string strtoupper(md5($timestamp.$appkey.$oauth_token.$oauth_token_secret.$appsecret))
uid false int uid与username参数必选其一
username false string uid与username参数必选其一
outformat false string 可选,返回数据格式,默认为json

注意事项

id为REST风格的参数,使用该参数的URL为:
http://open.tianya.cn/api/user/show.php
若取当前用信息错误,则返回400错误,提示:"error_code"=>"40002", "error_msg"=>"request data error"
如果该用户未授权应用,则返回错误信息,提示:"error_code":"40000","error_flag":false,"error_msg":"uid not Authorized"

返回结果

XML示例

<?xml version="1.0" encoding="utf8"?><user><user_id>51218315</user_id><user_name>opentest</user_name><register_date>1304403720000</register_date><head>http://tx.tianyaui.com/logo/man/51218315</head><sex>男 </sex><isvip>0</isvip><birthday>410198400000</birthday><location>海淀区    </location><describe>自我介绍</describe><hometown></hometown></user>

JSON示例

{"user":{"user_id":51218315,"user_name":"opentest","register_date":1304403720000,"head":"http:\/\/tx.tianyaui.com\/logo\/man\/51218315","sex":"\u7537 ","isvip":0,"birthday":410198400000,"location":"\u6d77\u6dc0\u533a ","describe":"\u81ea\u6211\u4ecb\u7ecd","hometown":null}}

字段说明

Userid :用户userid
User_name:用户名
register_date:注册日期(时间戳)
head:头像
sex:性别
isvip:是否是vip
birthday:生日
location:现在居住地
describe:描述
hometown:家乡

其他

PHP示例

SDK下载
代码示例如下:
include 'tyapi.php';
//参数设置
$appkey=;
$appsecret=;
$param['uid'] = ;
$url = 'http://open.tianya.cn/api/user/show.php';
$data = do_post($url,$appkey,$appsecret,$_SESSION["oauth_token"],$_SESSION["oauth_token_secret"],$param);

查看
个人工具
成功案例
帮助中心