friendships/create

关注一个用户。成功则返回关注人的资料，失败则返回一条字符串的说明。如果已经关注了此人，则返回http 403的状态.

URL

http://api.t.sina.com.cn/friendships/create/id.format

格式

xml, json

HTTP请求方式

POST

是否需要身份验证

true

请求数限制

false

请求参数

下面的参数必须有其中一个:

• id. 必填参数. 要关注的用户UID或用户帐号

o Example: http://api.t.sina.com.cn/friendships/create/12345.json or http://api.t.sina.com.cn/friendships/create/bob.xml

• user_id. 必填参数. 要关注的用户UID,主要是用在区分用户UID跟用户账号一样，产生歧义的时候。

o Example: http://api.t.sina.com.cn/friendships/create.xml?user_id=1401881

• screen_name.必填参数. 要关注的用户帐号,主要是用在区分用户UID跟用户账号一样，产生歧义的时候。

o Example: http://api.t.sina.com.cn/friendships/create.xml?screen_name=101010

• follow. 可选参数。将是自己粉丝的用户加为关注。

o Example: http://api.t.sina.com.cn/friendships/create/bob.json?follow=true

使用说明

• 此接口有更新上限，越权将返回http 403 错误

Response

XML示例:

 <?xml version="1.0" encoding="UTF-8"?>
 <user>
   <id>11075</id>
   <screen_name>name_11075</screen_name>
   <name>name_11075</name>
   <province>0</province>
   <city>0</city>
   <location></location>
   <description></description>
   <profile_image_url>http://tp4.sinaimg.cn/11075/50/0</profile_image_url>
   <domain>11075</domain>
   <gender></gender>
   <email></email>
   <qq>4102</qq>
   <msn>msn_4102</msn>
   <followers_count>28</followers_count>
   <friends_count>50</friends_count>
   <statuses_count>29</statuses_count>
   <favourites_count>0</favourites_count>
   <created_at>Thu Jan 01 08:00:00 +0800 1970</created_at>
   <following>false</following>
   <verified>true</verified>
   <geo_enabled>false</geo_enabled>
   <status>
     <created_at>Thu Jan 07 17:36:07 +0800 2010</created_at>
     <id>142309</id>
     <text>要查询的微博ID</text>
     <source>
       <a id="0" href="http://t.sina.com.cn">Web</a>
     </source>
     <favorited>false</favorited>
     <truncated>false</truncated>
     <geo/>
     <in_reply_to_status_id></in_reply_to_status_id>
     <in_reply_to_user_id></in_reply_to_user_id>
     <in_reply_to_screen_name></in_reply_to_screen_name>
   </status>
 </user>

JSON:示例

 {
   "id":11075,
   "screen_name":"name_11075",
   "name":"name_11075",
   "province":"0",
   "city":"0",
   "location":"",
   "description":"",
   "profile_image_url":"http://tp4.sinaimg.cn/11075/50/0",
   "domain":"11075",
   "email":"",
   "qq":"4102",
   "msn":"msn_4102",
   "followers_count":28,
   "friends_count":50,
   "statuses_count":29,
   "favourites_count":0,
   "created_at":"Thu Jan 01 08:00:00 +0800 1970",
   "following":false,
   "geo_enabled":false,
   "verified":true,
   "status":
         {"created_at":"Thu Jan 07 17:36:07 +0800 2010",
          "id":142309,
          "text":"要查询的微博ID",
          "source":"<a id=\"0\" href=\"http://t.sina.com.cn/\" rel=\"nofollow\">Web</a>",
          "favorited":false,
          "truncated":false,
          "in_reply_to_status_id":"",
          "in_reply_to_user_id":"",
          "in_reply_to_screen_name":"",
          "geo":null,
          "apiState":3}
  }

使用示例

cURL:

• xml:

curl -u user:password -d "" http://api.t.sina.com.cn/friendships/create/timyang.xml

• json:

curl -u user:password -d "" http://api.t.sina.com.cn/friendships/create/timyang.json