User/friends/update define

跳转到： 导航, 搜索

目录

User/friends/update define

更新用户关注的某一个用户的备注信息。

URL

http://api.t.sina.com.cn/user/friends/update_define.format

格式

xml, json

HTTP请求方式

POST

是否需要身份验证

True

请求数限制

True

请求参数

  • user_id：必选参数，想要修改备注信息的用户uid。
  • define_as：必选参数，想要为此用户修改的备注名称

返回结果

XML

<?xml version="1.0" encoding="UTF-8"?>
<user>
  <id>1266321801</id>
  <screen_name>姚晨</screen_name>
  <define_as>郭芙蓉扮演者</define_as>
  <name>姚晨</name>
  <province>11</province>
  <city>5</city>
  <location>北京 朝阳区</location>
  <description>一颗很逊的卤蛋。</description>
  <url>http://blog.sina.com.cn/yaochen</url>
  <profile_image_url>http://tp2.sinaimg.cn/1266321801/50/1283203855</profile_image_url>
  <domain>yaochen</domain>
  <gender>f</gender>
  <followers_count>2825298</followers_count>
  <friends_count>562</friends_count>
  <statuses_count>2160</statuses_count>
  <favourites_count>10</favourites_count>
  <created_at>Fri Aug 28 00:00:00 +0800 2009</created_at>
  <following>false</following>
  <verified>true</verified>
  <allow_all_act_msg>false</allow_all_act_msg>
  <geo_enabled>false</geo_enabled>
  <status>
    <created_at>Mon Sep 13 14:25:38 +0800 2010</created_at>
    <id>2585938903</id>
    <text>今日又和@陈奕利 导演一起吃饭，他说：上次我们吃饭被偷拍的那个绯闻让我很生气。我：是啊，我也很生气。陈导：不是的，我有个朋友说，这消息一看就是假的，姚晨怎么可能看上你呢？我有那么差吗？我太生气了！我：呃，导演，你节哀顺便...</text>
    <source>
      <a href="http://news.sina.com.cn/wap/wbclient.html#3">iPhone客户端</a>
    </source>
    <favorited>false</favorited>
    <truncated>false</truncated>
    <geo/>
    <in_reply_to_status_id/>
    <in_reply_to_user_id/>
    <in_reply_to_screen_name/>
    <thumbnail_pic>http://ss4.sinaimg.cn/thumbnail/4b7a89894901e2a285b43&690</thumbnail_pic>
    <bmiddle_pic>http://ss4.sinaimg.cn/bmiddle/4b7a89894901e2a285b43&690</bmiddle_pic>
    <original_pic>http://ss4.sinaimg.cn/orignal/4b7a89894901e2a285b43&690</original_pic>
  </status>
</user>

JSON

{
   "id":1266321801,
   "screen_name":"姚晨",
   "define_as":"郭芙蓉扮演者",
   "name":"姚晨",
   "province":"11",
   "city":"5",
   "location":"北京 朝阳区",
   "description":"一颗很逊的卤蛋。",
   "url":"http://blog.sina.com.cn/yaochen",
   "profile_image_url":"http://tp2.sinaimg.cn/1266321801/50/1283203855",
   "domain":"yaochen",
   "gender":"f",
   "followers_count":2825298,
   "friends_count":562,
   "statuses_count":2160,
   "favourites_count":10,
   "created_at":"Fri Aug 28 00:00:00 +0800 2009",
   "following":false,
   "allow_all_act_msg":false,
   "geo_enabled":false,
   "verified":true,
   "status":{
      "created_at":"Mon Sep 13 14:25:38 +0800 2010",
      "id":2585938903,
      "text":"今日又和@陈奕利 导演一起吃饭，他说：上次我们吃饭被偷拍的那个绯闻让我很生气。我：是啊，我也很生气。陈导：不是的，我有个朋友说，这消息一看就是假的，姚晨怎么可能看上你呢？我有那么差吗？我太生气了！我：呃，导演，你节哀顺便...",
      "source":"<a href=\"http://news.sina.com.cn/wap/wbclient.html#3\" rel=\"nofollow\">iPhone客户端</a>",
      "favorited":false,
      "truncated":false,
      "in_reply_to_status_id":"",
      "in_reply_to_user_id":"",
      "in_reply_to_screen_name":"",
      "thumbnail_pic":"http://ss4.sinaimg.cn/thumbnail/4b7a89894901e2a285b43&690",
      "bmiddle_pic":"http://ss4.sinaimg.cn/bmiddle/4b7a89894901e2a285b43&690",
      "original_pic":"http://ss4.sinaimg.cn/orignal/4b7a89894901e2a285b43&690",
      "geo":null
   }
}

字段说明 - 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，如果不是转发，则没有此字段

使用示例

  • xml:

curl -u uid:password "http://api.t.sina.com.cn/users/show.xml?screen_name=timyang&source=appkey"

  • json:

curl -u uid:password http://api.t.sina.com.cn/users/show/11054.json or http://api.t.sina.com.cn/users/show/11054.xml?source=appkey

Java示例

请从 微博SDK开发包下载 下载Java SDK
代码示例如下: 

package weibo4j.examples;

import weibo4j.User;
import weibo4j.Weibo;
import weibo4j.WeiboException; 

public class GetUserInfo {

	/**
	 * 根据用户ID获取用户资料（授权用户） 
	 * @param args
	 */
	public static void main(String[] args) {
		System.setProperty("weibo4j.oauth.consumerKey", Weibo.CONSUMER_KEY);
    	System.setProperty("weibo4j.oauth.consumerSecret", Weibo.CONSUMER_SECRET);
		try {
			User user = getWeibo(true,args).showUser(args[2]);
			System.out.println(user.toString());
		} catch (WeiboException e) {
			e.printStackTrace();
		}
	}
	
	private static Weibo getWeibo(boolean isOauth,String[] args) {
		Weibo weibo = new Weibo();
		if(isOauth) {//oauth验证方式 args[0]:访问的token；args[1]:访问的密匙
			weibo.setToken(args[0], args[1]);
		}else {//用户登录方式
    		weibo.setUserId(args[0]);//用户名/ID
   		weibo.setPassword(args[1]);//密码
		}
		return weibo;
	}
}

PHP示例

请从 微博SDK开发包下载 处下载PHP SDK（支持OAuth验证之版本）
代码示例如下: 

//users/show
//根据用户ID获取用户资料（授权用户）
$c = new WeiboClient( WB_AKEY , 
                      WB_SKEY , 
                      $_SESSION['last_key']['oauth_token'] , 
                      $_SESSION['last_key']['oauth_token_secret']  );
//用户ID
$u_id = "u_id";
$msg = $c->show_user($u_id);
if ($msg === false || $msg === null){
	echo "Error occured";
	return false;
}
if (isset($msg['error_code']) && isset($msg['error'])){
	echo ('Error_code: '.$msg['error_code'].';  Error: '.$msg['error'] );
	return false;
}
echo($msg['id'].' : '.$msg['name'].'  '.$msg['created_at']);
来自“http://open.weibo.com/wiki/index.php?title=User/friends/update_define&oldid=2295”