GET/:user/:list id/subscribers

跳转到: 导航, 搜索
(创建新页面为 '==:user/:list_id/subscribers == 返回特定list的所有订阅者 ===URL=== http://api.t.sina.com.cn/:user/:list_id/subscribers.format ===格式=== xml, json ===HTTP请求…')
 
(:user/:list_id/subscribers)
 
(未显示1个用户的5个中间版本)
第2行: 第2行:
 
返回特定list的所有订阅者
 
返回特定list的所有订阅者
  
===URL===
+
==URL==
 
http://api.t.sina.com.cn/:user/:list_id/subscribers.format
 
http://api.t.sina.com.cn/:user/:list_id/subscribers.format
 
   
 
   
===格式===
+
==格式==
 
xml, json
 
xml, json
 
   
 
   
===HTTP请求方式===
+
==HTTP请求方式==
 
GET
 
GET
 
   
 
   
===是否需要登录===
+
==是否需要登录==
 
true
 
true
 
   
 
   
===请求数限制===
+
==请求数限制==
 
true
 
true
 
   
 
   
===请求参数===
+
==请求参数==
*Id: 必选参数。List的id或slug(list的名称)
+
* cursor: 可选参数。将结果分页,每一页包含20个lists。由-1开始分页,定位一个id地址,通过比较id大小实现next_cursor 和 previous_cursor向前或向后翻页。
*Cursor: 可选参数。将结果分页,每一页包含20个lists。由-1开始分页,定位一个id地址,通过比较id大小实现next_cursor 和 previous_cursor向前或向后翻页。
+
 
 +
==使用示例==
 +
====XML====
 +
curl -u uid:password http://api.t.sina.com.cn/testuser/testlist/subscribers.xml?source=appkey
 +
====json====
 +
curl -u uid:password http://api.t.sina.com.cn/testuser/testlist/subscribers.json?source=appkey
 +
 
 +
==返回结果==
 +
====XML====
 +
<pre>
 +
<?xml version="1.0" encoding="UTF-8"?>
 +
<users_list>
 +
  <users>
 +
    <user>
 +
      <id>1796414563</id>
 +
      <screen_name>iMarvin</screen_name>
 +
      <name>iMarvin</name>
 +
      <province>11</province>
 +
      <city>8</city>
 +
      <location>北京 海淀区</location>
 +
      <description/>
 +
      <url/>
 +
      <profile_image_url>http://tp4.sinaimg.cn/1796414563/50/0</profile_image_url>
 +
      <domain>imarvin</domain>
 +
      <gender>m</gender>
 +
      <followers_count>0</followers_count>
 +
      <friends_count>20</friends_count>
 +
      <statuses_count>1</statuses_count>
 +
      <favourites_count>0</favourites_count>
 +
      <created_at>Mon Aug 16 00:00:00 +0800 2010</created_at>
 +
      <following>false</following>
 +
      <verified>false</verified>
 +
      <allow_all_act_msg>false</allow_all_act_msg>
 +
      <geo_enabled>false</geo_enabled>
 +
      <status>
 +
        <created_at>Mon Aug 16 18:36:40 +0800 2010</created_at>
 +
        <id>1787253885</id>
 +
        <text>Hello world</text>
 +
        <source>
 +
          <a href="http://airweibo.sinaapp.com/">AIR微博</a>
 +
        </source>
 +
        <favorited>false</favorited>
 +
        <truncated>false</truncated>
 +
        <geo/>
 +
        <in_reply_to_status_id/>
 +
        <in_reply_to_user_id/>
 +
        <in_reply_to_screen_name/>
 +
      </status>
 +
    </user>
 +
  </users>
 +
  <previous_curosr>0</previous_curosr>
 +
  <next_curosr>0</next_curosr>
 +
</users_list>
 +
</pre>
 +
====json====
 +
<pre>
 +
{
 +
    "next_cursor": 0,
 +
    "previous_curosr": 0,
 +
    "users": [
 +
        {
 +
            "allow_all_act_msg": false,
 +
            "city": "8",
 +
            "created_at": "Mon Aug 16 00:00:00 +0800 2010",
 +
            "description": "",
 +
            "domain": "imarvin",
 +
            "favourites_count": 0,
 +
            "followers_count": 0,
 +
            "following": false,
 +
            "friends_count": 20,
 +
            "gender": "m",
 +
            "geo_enabled": false,
 +
            "id": 1796414563,
 +
            "location": "\u5317\u4eac \u6d77\u6dc0\u533a",
 +
            "name": "iMarvin",
 +
            "profile_image_url": "http://tp4.sinaimg.cn/1796414563/50/0",
 +
            "province": "11",
 +
            "screen_name": "iMarvin",
 +
            "status": {
 +
                "created_at": "Mon Aug 16 18:36:40 +0800 2010",
 +
                "favorited": false,
 +
                "geo": null,
 +
                "id": 1787253885,
 +
                "in_reply_to_screen_name": "",
 +
                "in_reply_to_status_id": "",
 +
                "in_reply_to_user_id": "",
 +
                "source": "<a href=\"http://airweibo.sinaapp.com//\" rel=\"nofollow\">AIR\u5fae\u535a</a>",
 +
                "text": "Hello world",
 +
                "truncated": false
 +
            },
 +
            "statuses_count": 1,
 +
            "url": "",
 +
            "verified": false
 +
        }
 +
    ]
 +
}
 +
</pre>

2010年12月24日 (五) 17:34的最后版本

目录

:user/:list_id/subscribers

返回特定list的所有订阅者

URL

http://api.t.sina.com.cn/:user/:list_id/subscribers.format

格式

xml, json

HTTP请求方式

GET

是否需要登录

true

请求数限制

true

请求参数

  • cursor: 可选参数。将结果分页,每一页包含20个lists。由-1开始分页,定位一个id地址,通过比较id大小实现next_cursor 和 previous_cursor向前或向后翻页。

使用示例

XML

curl -u uid:password http://api.t.sina.com.cn/testuser/testlist/subscribers.xml?source=appkey

json

curl -u uid:password http://api.t.sina.com.cn/testuser/testlist/subscribers.json?source=appkey

返回结果

XML

<?xml version="1.0" encoding="UTF-8"?>
<users_list>
  <users>
    <user>
      <id>1796414563</id>
      <screen_name>iMarvin</screen_name>
      <name>iMarvin</name>
      <province>11</province>
      <city>8</city>
      <location>北京 海淀区</location>
      <description/>
      <url/>
      <profile_image_url>http://tp4.sinaimg.cn/1796414563/50/0</profile_image_url>
      <domain>imarvin</domain>
      <gender>m</gender>
      <followers_count>0</followers_count>
      <friends_count>20</friends_count>
      <statuses_count>1</statuses_count>
      <favourites_count>0</favourites_count>
      <created_at>Mon Aug 16 00:00:00 +0800 2010</created_at>
      <following>false</following>
      <verified>false</verified>
      <allow_all_act_msg>false</allow_all_act_msg>
      <geo_enabled>false</geo_enabled>
      <status>
        <created_at>Mon Aug 16 18:36:40 +0800 2010</created_at>
        <id>1787253885</id>
        <text>Hello world</text>
        <source>
          <a href="http://airweibo.sinaapp.com/">AIR微博</a>
        </source>
        <favorited>false</favorited>
        <truncated>false</truncated>
        <geo/>
        <in_reply_to_status_id/>
        <in_reply_to_user_id/>
        <in_reply_to_screen_name/>
      </status>
    </user>
  </users>
  <previous_curosr>0</previous_curosr>
  <next_curosr>0</next_curosr>
</users_list>

json

{
    "next_cursor": 0, 
    "previous_curosr": 0, 
    "users": [
        {
            "allow_all_act_msg": false, 
            "city": "8", 
            "created_at": "Mon Aug 16 00:00:00 +0800 2010", 
            "description": "", 
            "domain": "imarvin", 
            "favourites_count": 0, 
            "followers_count": 0, 
            "following": false, 
            "friends_count": 20, 
            "gender": "m", 
            "geo_enabled": false, 
            "id": 1796414563, 
            "location": "\u5317\u4eac \u6d77\u6dc0\u533a", 
            "name": "iMarvin", 
            "profile_image_url": "http://tp4.sinaimg.cn/1796414563/50/0", 
            "province": "11", 
            "screen_name": "iMarvin", 
            "status": {
                "created_at": "Mon Aug 16 18:36:40 +0800 2010", 
                "favorited": false, 
                "geo": null, 
                "id": 1787253885, 
                "in_reply_to_screen_name": "", 
                "in_reply_to_status_id": "", 
                "in_reply_to_user_id": "", 
                "source": "<a href=\"http://airweibo.sinaapp.com//\" rel=\"nofollow\">AIR\u5fae\u535a</a>", 
                "text": "Hello world", 
                "truncated": false
            }, 
            "statuses_count": 1, 
            "url": "", 
            "verified": false
        }
    ]
}
文档更新时间: 2010-12-24