Notifications/follow

跳转到: 导航, 搜索
(notifications/follow)
(返回:)
 
(未显示1个用户的5个中间版本)
第1行: 第1行:
 
== notifications/follow ==
 
== notifications/follow ==
 
允许通知更新给指定用户。如果成功返回用户信息
 
允许通知更新给指定用户。如果成功返回用户信息
 
 
Enables device notifications for updates from the specified user.  Returns the specified user when successful.
 
  
 
=== URL: ===
 
=== URL: ===
 
http://api.t.sina.com.cn/notifications/follow/id.format
 
http://api.t.sina.com.cn/notifications/follow/id.format
 
   
 
   
===Formats:===
+
===格式:===
 
xml, json
 
xml, json
 
   
 
   
=== HTTP Method(s): ===
+
=== HTTP请求方式: ===
 
POST
 
POST
+
 
===Requires Authentication (about authentication):===
+
===是否需要登录: ===
 
true
 
true
  
===API rate limited (about rate limiting):===
+
===请求数限制: ===
 
false
 
false
  
===Parameters:===
+
===请求参数:===
 
下面参数必须传递一个:
 
下面参数必须传递一个:
 
* id.  必选参数. 指定的用户ID或用户帐号。  
 
* id.  必选参数. 指定的用户ID或用户帐号。  
第29行: 第26行:
 
o Example: http://api.t.sina.com.cn/notifications/follow.xml?screen_name=101010
 
o Example: http://api.t.sina.com.cn/notifications/follow.xml?screen_name=101010
  
 
+
===返回: ===
One of the following is required:
+
XML示例:  
* id.  Required. The ID or screen name of the user to follow with device updates. 
+
o Example: http://api.t.sina.com.cn/notifications/follow/12345.json or http://api.t.sina.com.cn/friendships/create/bob.xml
+
* user_id. Required. Specfies the ID of the user to follow with device updates. Helpful for disambiguating when a valid user ID is also a valid screen name.
+
o Example: http://api.t.sina.com.cn/notificiations/follow.xml?user_id=1401881
+
* screen_name. Required. Specfies the screen name of the user to follow with device updates. Helpful for disambiguating when a valid screen name is also a user ID.
+
o Example: http://api.t.sina.com.cn/notifications/follow.xml?screen_name=101010
+
 
+
 
+
===Response (about return values): ===
+
XML example (truncated):
+
 
  <?xml version="1.0" encoding="UTF-8"?>
 
  <?xml version="1.0" encoding="UTF-8"?>
<user>
+
  <user>
<id>1401881</id>
+
  <id>10503</id>
<name>Doug Williams</name>
+
  <screen_name>timyang</screen_name>
<screen_name>dougw</screen_name>
+
  <name>Tim Yang</name>
<location>San Francisco, CA</location>
+
  <location>广州</location>
<description>Twitter API Support. Internet, greed, users, dougw and opportunities are my passions.</description>
+
  <description>blog: timyang.net</description>
<profile_image_url>http://s3.amazonaws.com/twitter_production/profile_images/59648642/avatar_normal.png</profile_image_url>
+
  <profile_image_url>http://tt8.sinaimg.cn/10503/50/1256306049</profile_image_url>
<url>http://www.igudo.com</url>
+
  <followers_count>0</followers_count>
<protected>false</protected>
+
  <friends_count>0</friends_count>
<followers_count>1031</followers_count>
+
  <statuses_count>0</statuses_count>
<profile_background_color>9ae4e8</profile_background_color>
+
  <favourites_count>0</favourites_count>
<profile_text_color>000000</profile_text_color>
+
  <status>
<profile_link_color>0000ff</profile_link_color>
+
    <id>8374590856</id>
<profile_sidebar_fill_color>e0ff92</profile_sidebar_fill_color>
+
    <text>微博平台很重要的一点在于多渠道,使得用户可以随时随地随意收发信息,我们会在这个 方向努力的。</text>
<profile_sidebar_border_color>87bc44</profile_sidebar_border_color>
+
    <source>
<friends_count>293</friends_count>
+
      <a href="http://t.sina.com.cn">Web</a>
<created_at>Sun Mar 18 06:42:26 +0000 2007</created_at>
+
    </source>
<favourites_count>0</favourites_count>
+
    <favorited>false</favorited>
<utc_offset>-18000</utc_offset>
+
    <truncated>false</truncated>
<time_zone>Eastern Time (US & Canada)</time_zone>
+
    <created_at>Tue Nov 17 20:11:24 +0800 2009</created_at>
<profile_background_image_url>http://s3.amazonaws.com/twitter_production/profile_background_images/2752608/twitter_bg_grass.jpg</profile_background_image_url>
+
    </status>
<profile_background_tile>false</profile_background_tile>
+
  </user>
<statuses_count>3390</statuses_count>
+
<notifications>sms</notifications>
+
<following>true</following>
+
<verified>true</verified>
+
<status>
+
<created_at>Tue Apr 07 22:52:51 +0000 2009</created_at>
+
<id>1472669360</id>
+
<text>At least I can get your humor through tweets. RT @abdur: I don't mean this in a bad way, but genetically speaking your a cul-de-sac.</text>
+
<source><a href="http://www.tweetdeck.com/">TweetDeck</a></source>
+
<truncated>false</truncated>
+
<in_reply_to_status_id></in_reply_to_status_id>
+
<in_reply_to_user_id></in_reply_to_user_id>
+
<favorited>false</favorited>
+
<in_reply_to_screen_name></in_reply_to_screen_name>
+
</status>
+
</user>  
+
 
+
===Usage examples: ===
+
cURL (about cURL):
+
  
 +
===使用示例: ===
 
curl -u user:password -d "" http://api.t.sina.com.cn/notifications/follow/dougw.xml
 
curl -u user:password -d "" http://api.t.sina.com.cn/notifications/follow/dougw.xml

2009年11月18日 (三) 18:52的最后版本

目录

notifications/follow

允许通知更新给指定用户。如果成功返回用户信息

URL:

http://api.t.sina.com.cn/notifications/follow/id.format

格式:

xml, json

HTTP请求方式:

POST

是否需要登录:

true

请求数限制:

false

请求参数:

下面参数必须传递一个:

  • id. 必选参数. 指定的用户ID或用户帐号。

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

  • user_id. 必选参数. 指定的用户ID

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

  • screen_name. 必选参数. 指定的用户帐号.

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

返回:

XML示例:

<?xml version="1.0" encoding="UTF-8"?>
 <user>
 <id>10503</id>
 <screen_name>timyang</screen_name>
  <name>Tim Yang</name>
  <location>广州</location>
  <description>blog: timyang.net</description>
  <profile_image_url>http://tt8.sinaimg.cn/10503/50/1256306049</profile_image_url>
  <followers_count>0</followers_count>
  <friends_count>0</friends_count>
  <statuses_count>0</statuses_count>
  <favourites_count>0</favourites_count>
  <status>
   <id>8374590856</id>
   <text>微博平台很重要的一点在于多渠道,使得用户可以随时随地随意收发信息,我们会在这个 方向努力的。</text>
   <source>
     <a href="http://t.sina.com.cn">Web</a>
   </source>
   <favorited>false</favorited>
   <truncated>false</truncated>
   <created_at>Tue Nov 17 20:11:24 +0800 2009</created_at>
   </status>
 </user>

使用示例:

curl -u user:password -d "" http://api.t.sina.com.cn/notifications/follow/dougw.xml

文档更新时间: 2009-11-18