POST/:user/lists/:list id

跳转到: 导航, 搜索

目录

:user/lists/:list_id

更新指定的list。

URL

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

格式

xml, json

HTTP请求方式

POST, PUT

是否需要登录

true

请求数限制

false

请求参数

  • name: 必选参数。10个汉字的长度(20个字符的长度),汉字、字母,横线(不能用下划线),其他字符自动替换成横线,名称不能重复。
  • description:可选参数。70个汉字。可填写全角、半角符号。只有公有list才有此内容。

使用示例

XML

curl -u uid:password -d "source=appkey&name=newlist" http://api.t.sina.com.cn/testuser/lists/testlist.xml

Json

curl -u uid:password -d "source=appkey&name=newlist" http://api.t.sina.com.cn/testuser/lists/testlist.json

返回结果

XML

<?xml version="1.0" encoding="UTF-8"?>
<list>
  <id>343</id>
  <name>newlist</name>
  <full_name>@testuser/newlist</full_name>
  <slug>testuser</slug>
  <description/>
  <subscriber_count>0</subscriber_count>
  <member_count>0</member_count>
  <uri>/testuser/newlist</uri>
  <mode>public</mode>
  <user>
    <id>1642466141</id>
    <screen_name>testuser</screen_name>
    <name>testuser</name>
    <province>11</province>
    <city>8</city>
    <location>北京 海淀区</location>
    <description></description>
    <url>http://tuoniao.org</url>
    <profile_image_url>http://tp2.sinaimg.cn/1642466141/50/1281523744</profile_image_url>
    <domain>testuser</domain>
    <gender>m</gender>
    <followers_count>41</followers_count>
    <friends_count>55</friends_count>
    <statuses_count>43</statuses_count>
    <favourites_count>0</favourites_count>
    <created_at>Fri Aug 28 00:00:00 +0800 2009</created_at>
    <following>false</following>
    <verified>false</verified>
    <allow_all_act_msg>false</allow_all_act_msg>
    <geo_enabled>false</geo_enabled>
  </user>
</list>

Json

{
    "description": "", 
    "full_name": "@testuser/newlist", 
    "id": 343, 
    "member_count": 0, 
    "mode": "public", 
    "name": "newlist", 
    "slug": "newlist", 
    "subscriber_count": 0, 
    "uri": "/testuser/newlist", 
    "user": {
        "allow_all_act_msg": false, 
        "city": "8", 
        "created_at": "Fri Aug 28 00:00:00 +0800 2009", 
        "description": "\u53ef\u60b2\u7684\u4e2d\u56fd\u4e92\u8054\u7f51\u4ece\u4e1a\u8005\uff0c\u4e0d\u660e\u771f\u76f8\u7684\u7fa4\u4f17\u3002", 
        "domain": "testuser", 
        "favourites_count": 0, 
        "followers_count": 41, 
        "following": false, 
        "friends_count": 55, 
        "gender": "m", 
        "geo_enabled": false, 
        "id": 1642466141, 
        "location": "\u5317\u4eac \u6d77\u6dc0\u533a", 
        "name": "testuser", 
        "profile_image_url": "http://tp2.sinaimg.cn/1642466141/50/1281523744", 
        "province": "11", 
        "screen_name": "testuser", 
        "statuses_count": 43, 
        "url": "http://tuoniao.org", 
        "verified": false
    }
}