Blocks/destroy

跳转到: 导航, 搜索
(创建新页面为 '== blocks/destroy == Un-blocks the user specified in the ID parameter for the authenticating user. Returns the un-blocked user in the requested format when successful. === UR…')
 
(blocks/destroy)
第1行: 第1行:
 
== blocks/destroy ==
 
== blocks/destroy ==
Un-blocks the user specified in the ID parameter for the authenticating user.  Returns the un-blocked user in the requested format when successful.
+
删黑名单
  
 
=== URL: ===
 
=== URL: ===
http://api.t.sina.com.cn/blocks/destroy/id.format
+
http://api.t.sina.com.cn/blocks/destroy.format
 
   
 
   
===Formats:===
+
===格式:===
 
xml, json
 
xml, json
 
   
 
   
=== HTTP Method(s): ===
+
=== 请求方式: ===
 
POST, DELETE
 
POST, DELETE
 
   
 
   
===Requires Authentication (about authentication):===
+
===是否需要登录:===
 
true
 
true
  
===API rate limited (about rate limiting):===
+
===请求数限制:===
 
false
 
false
  
===Parameters:===
+
===请求参数:===
One of the following is required:
+
必选参数(至少选一个)
* id.  Optional.  The ID or screen_name of the potentially blocked user.
+
* user_id.  要删除黑名单的用户ID
o Example: http://api.t.sina.com.cn/blocks/destroy/bob.xml
+
* user_id.  Optional.  Specfies the ID of the potentially blocked user. Helpful for disambiguating when a valid user ID is also a valid screen name.
+
 
o Example: http://api.t.sina.com.cn/blocks/destroy.xml?user_id=1401881  
 
o Example: http://api.t.sina.com.cn/blocks/destroy.xml?user_id=1401881  
* screen_name. Optional.  Specfies the screen name of the potentially blocked user. Helpful for disambiguating when a valid screen name is also a user ID.
+
* screen_name. 要删除黑名单的用户昵称
 
o Example: http://api.t.sina.com.cn/blocks/destroy.xml?screen_name=101010  
 
o Example: http://api.t.sina.com.cn/blocks/destroy.xml?screen_name=101010  
 
+
===使用说明===
===Response (about return values): ===
+
*user_id或screen_name若不存在返回400
XML example (truncated):
+
===返回结果: ===
<?xml version="1.0" encoding="UTF-8"?>
+
XML:
 
  <user>
 
  <user>
  <id>1401881</id>
+
  <id>1266321801</id>
  <name>Doug Williams</name>
+
<screen_name>姚晨</screen_name>
  <screen_name>dougw</screen_name>
+
  <name>姚晨</name>
  <location>San Francisco, CA</location>
+
  <province>11</province>
  <description>Twitter API Support. Internet, greed, users, dougw and opportunities are my passions.</description>
+
<city>5</city>
  <profile_image_url>http://s3.amazonaws.com/twitter_production/profile_images/59648642/avatar_normal.png</profile_image_url>
+
  <location>北京 朝阳区</location>
  <url>http://www.igudo.com</url>
+
  <description>一颗很逊的卤蛋。</description>
<protected>false</protected>
+
  <url>http://blog.sina.com.cn/yaochen</url>
<followers_count>1031</followers_count>
+
  <profile_image_url>http://tp2.sinaimg.cn/1266321801/50/1283203855</profile_image_url>
<profile_background_color>9ae4e8</profile_background_color>
+
  <domain>yaochen</domain>
  <profile_text_color>000000</profile_text_color>
+
  <gender>f</gender>
  <profile_link_color>0000ff</profile_link_color>
+
  <followers_count>3284142</followers_count>
  <profile_sidebar_fill_color>e0ff92</profile_sidebar_fill_color>
+
  <friends_count>620</friends_count>
<profile_sidebar_border_color>87bc44</profile_sidebar_border_color>
+
  <statuses_count>2361</statuses_count>
  <friends_count>293</friends_count>
+
  <favourites_count>14</favourites_count>
  <created_at>Sun Mar 18 06:42:26 +0000 2007</created_at>
+
  <created_at>Fri Aug 28 00:00:00 +0800 2009</created_at>
  <favourites_count>0</favourites_count>
+
  <utc_offset>-18000</utc_offset>
+
<time_zone>Eastern Time (US & Canada)</time_zone>
+
<profile_background_image_url>http://s3.amazonaws.com/twitter_production/profile_background_images/2752608/twitter_bg_grass.jpg</profile_background_image_url>
+
<profile_background_tile>false</profile_background_tile>
+
<statuses_count>3390</statuses_count>
+
<notifications>false</notifications>
+
 
  <following>false</following>
 
  <following>false</following>
 
  <verified>true</verified>
 
  <verified>true</verified>
 +
<allow_all_act_msg>false</allow_all_act_msg>
 +
<geo_enabled>true</geo_enabled>
 
  <status>
 
  <status>
<created_at>Tue Apr 07 22:52:51 +0000 2009</created_at>
+
  <created_at>Mon Oct 18 11:44:53 +0800 2010</created_at>
<id>1472669360</id>
+
  <id>3141808011</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>
+
  <text>冕冕,加油!</text>
<source><a href="http://www.tweetdeck.com/">TweetDeck</a></source>
+
  <source>
<truncated>false</truncated>
+
    <a href="http://news.sina.com.cn/wap/wbclient.html#3">iPhone客户端</a>
<in_reply_to_status_id></in_reply_to_status_id>
+
  </source>
<in_reply_to_user_id></in_reply_to_user_id>
+
  <favorited>false</favorited>
<favorited>false</favorited>
+
  <truncated>false</truncated>
<in_reply_to_screen_name></in_reply_to_screen_name>
+
  <geo/>
 +
  <in_reply_to_status_id/>
 +
  <in_reply_to_user_id/>
 +
  <in_reply_to_screen_name/>
 +
  <retweeted_status>
 +
    <created_at>Mon Oct 18 10:06:57 +0800 2010</created_at>
 +
    <id>3140482259</id>
 +
    <text>刚跑完100米圣途,蓮花山清幽的山徑,闊葉榕很高兴,我也很高兴。出山门了,这是我的"潮流"!答应妈妈了,要送给她!</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://ss3.sinaimg.cn/thumbnail/3f1622c9492daa18d5612&690</thumbnail_pic>
 +
    <bmiddle_pic>http://ss3.sinaimg.cn/bmiddle/3f1622c9492daa18d5612&690</bmiddle_pic>
 +
    <original_pic>http://ss3.sinaimg.cn/orignal/3f1622c9492daa18d5612&690</original_pic>
 +
    <user>
 +
      <id>1058415305</id>
 +
      <screen_name>行者孙冕</screen_name>
 +
      <name>行者孙冕</name>
 +
      <province>44</province>
 +
      <city>1</city>
 +
      <location>广东 广州</location>
 +
      <description/>
 +
      <url>http://blog.sina.com.cn/sunmian</url>
 +
      <profile_image_url>http://tp2.sinaimg.cn/1058415305/50/1279874506</profile_image_url>
 +
      <domain>sunmian</domain>
 +
      <gender>m</gender>
 +
      <followers_count>64184</followers_count>
 +
      <friends_count>409</friends_count>
 +
      <statuses_count>2269</statuses_count>
 +
      <favourites_count>32</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>true</geo_enabled>
 +
    </user>
 +
  </retweeted_status>
 
  </status>
 
  </status>
</user>
+
JSON:
 +
{
 +
 
 +
  "allow_all_act_msg": false,
 +
  "city": "5",
 +
  "created_at": "Fri Aug 28 00:00:00 +0800 2009",
 +
  "description": "一颗很逊的卤蛋。",
 +
  "domain": "yaochen",
 +
  "favourites_count": 14,
 +
  "followers_count": 3284142,
 +
  "following": false,
 +
  "friends_count": 620,
 +
  "gender": "f",
 +
  "geo_enabled": true,
 +
  "id": 1266321801,
 +
  "location": "北京 朝阳区",
 +
  "name": "姚晨",
 +
  "profile_image_url": "http://tp2.sinaimg.cn/1266321801/50/1283203855",
 +
  "province": "11",
 +
  "screen_name": "姚晨",
 +
  "status": {
 +
      "created_at": "Mon Oct 18 11:44:53 +0800 2010",
 +
      "favorited": false,
 +
      "geo": null,
 +
      "id": 3141808011,
 +
      "in_reply_to_screen_name": "",
 +
      "in_reply_to_status_id": "",
 +
      "in_reply_to_user_id": "",
 +
      "retweeted_status": {
 +
          "bmiddle_pic": "http://ss3.sinaimg.cn/bmiddle/3f1622c9492daa18d5612&690",
 +
          "created_at": "Mon Oct 18 10:06:57 +0800 2010",
 +
          "favorited": false,
 +
          "geo": null,
 +
          "id": 3140482259,
 +
          "in_reply_to_screen_name": "",
 +
          "in_reply_to_status_id": "",
 +
          "in_reply_to_user_id": "",
 +
          "original_pic": "http://ss3.sinaimg.cn/orignal/3f1622c9492daa18d5612&690",
 +
          "source": "<a href=\"http://news.sina.com.cn/wap/wbclient.html#3\" rel=\"nofollow\">iPhone客户端</a>",
 +
          "text": "刚跑完100米圣途,蓮花山清幽的山徑,闊葉榕很高兴,我也很高兴。出山门了,这是我的"潮流"!答应妈妈了,要送给她!",
 +
          "thumbnail_pic": "http://ss3.sinaimg.cn/thumbnail/3f1622c9492daa18d5612&690",
 +
          "truncated": false,
 +
          "user": {
 +
              "allow_all_act_msg": false,
 +
              "city": "1",
 +
              "created_at": "Fri Aug 28 00:00:00 +0800 2009",
 +
              "description": "",
 +
              "domain": "sunmian",
 +
              "favourites_count": 32,
 +
              "followers_count": 64184,
 +
              "following": false,
 +
              "friends_count": 409,
 +
              "gender": "m",
 +
              "geo_enabled": true,
 +
              "id": 1058415305,
 +
              "location": "广东 广州",
 +
              "name": "行者孙冕",
 +
              "profile_image_url": "http://tp2.sinaimg.cn/1058415305/50/1279874506",
 +
              "province": "44",
 +
              "screen_name": "行者孙冕",
 +
              "statuses_count": 2269,
 +
              "url": "http://blog.sina.com.cn/sunmian",
 +
              "verified": true
 +
          }
 +
      },
 +
      "source": "<a href=\"http://news.sina.com.cn/wap/wbclient.html#3\" rel=\"nofollow\">iPhone\u5ba2\u6237\u7aef</a>",
 +
      "text": "冕冕,加油!",
 +
      "truncated": false
 +
  },
 +
  "statuses_count": 2361,
 +
  "url": "http://blog.sina.com.cn/yaochen",
 +
  "verified": true
  
===Usage examples: ===
+
}
cURL (about cURL):
+
  
curl -u user:password http://api.t.sina.com.cn/blocks/destory/dougw.xml
+
===使用示例: ===
 +
curl -u jkl0000@sina.cn:123456 -d "source=1481449075&user_id=1796213571" http://api.t.sina.com.cn/blocks/destroy.json

2010年10月18日 (一) 17:26的版本

目录

blocks/destroy

删黑名单

URL:

http://api.t.sina.com.cn/blocks/destroy.format

格式:

xml, json

请求方式:

POST, DELETE

是否需要登录:

true

请求数限制:

false

请求参数:

必选参数(至少选一个)

  • user_id. 要删除黑名单的用户ID

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

  • screen_name. 要删除黑名单的用户昵称

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

使用说明

  • user_id或screen_name若不存在返回400

返回结果:

XML:

<user>
<id>1266321801</id>
<screen_name>姚晨</screen_name>
<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>3284142</followers_count>
<friends_count>620</friends_count>
<statuses_count>2361</statuses_count>
<favourites_count>14</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>true</geo_enabled>
<status>
  <created_at>Mon Oct 18 11:44:53 +0800 2010</created_at>
  <id>3141808011</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/>
  <retweeted_status>
    <created_at>Mon Oct 18 10:06:57 +0800 2010</created_at>
    <id>3140482259</id>
    <text>刚跑完100米圣途,蓮花山清幽的山徑,闊葉榕很高兴,我也很高兴。出山门了,这是我的"潮流"!答应妈妈了,要送给她!</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://ss3.sinaimg.cn/thumbnail/3f1622c9492daa18d5612&690</thumbnail_pic>
    <bmiddle_pic>http://ss3.sinaimg.cn/bmiddle/3f1622c9492daa18d5612&690</bmiddle_pic>
    <original_pic>http://ss3.sinaimg.cn/orignal/3f1622c9492daa18d5612&690</original_pic>
    <user>
      <id>1058415305</id>
      <screen_name>行者孙冕</screen_name>
      <name>行者孙冕</name>
      <province>44</province>
      <city>1</city>
      <location>广东 广州</location>
      <description/>
      <url>http://blog.sina.com.cn/sunmian</url>
      <profile_image_url>http://tp2.sinaimg.cn/1058415305/50/1279874506</profile_image_url>
      <domain>sunmian</domain>
      <gender>m</gender>
      <followers_count>64184</followers_count>
      <friends_count>409</friends_count>
      <statuses_count>2269</statuses_count>
      <favourites_count>32</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>true</geo_enabled>
    </user>
  </retweeted_status>
</status>

JSON: {

  "allow_all_act_msg": false, 
  "city": "5", 
  "created_at": "Fri Aug 28 00:00:00 +0800 2009", 
  "description": "一颗很逊的卤蛋。", 
  "domain": "yaochen", 
  "favourites_count": 14, 
  "followers_count": 3284142, 
  "following": false, 
  "friends_count": 620, 
  "gender": "f", 
  "geo_enabled": true, 
  "id": 1266321801, 
  "location": "北京 朝阳区", 
  "name": "姚晨", 
  "profile_image_url": "http://tp2.sinaimg.cn/1266321801/50/1283203855", 
  "province": "11", 
  "screen_name": "姚晨", 
  "status": {
      "created_at": "Mon Oct 18 11:44:53 +0800 2010", 
      "favorited": false, 
      "geo": null, 
      "id": 3141808011, 
      "in_reply_to_screen_name": "", 
      "in_reply_to_status_id": "", 
      "in_reply_to_user_id": "", 
      "retweeted_status": {
          "bmiddle_pic": "http://ss3.sinaimg.cn/bmiddle/3f1622c9492daa18d5612&690", 
          "created_at": "Mon Oct 18 10:06:57 +0800 2010", 
          "favorited": false, 
          "geo": null, 
          "id": 3140482259, 
          "in_reply_to_screen_name": "", 
          "in_reply_to_status_id": "", 
          "in_reply_to_user_id": "", 
          "original_pic": "http://ss3.sinaimg.cn/orignal/3f1622c9492daa18d5612&690", 
          "source": "<a href=\"http://news.sina.com.cn/wap/wbclient.html#3\" rel=\"nofollow\">iPhone客户端</a>", 
          "text": "刚跑完100米圣途,蓮花山清幽的山徑,闊葉榕很高兴,我也很高兴。出山门了,这是我的"潮流"!答应妈妈了,要送给她!", 
          "thumbnail_pic": "http://ss3.sinaimg.cn/thumbnail/3f1622c9492daa18d5612&690", 
          "truncated": false, 
          "user": {
              "allow_all_act_msg": false, 
              "city": "1", 
              "created_at": "Fri Aug 28 00:00:00 +0800 2009", 
              "description": "", 
              "domain": "sunmian", 
              "favourites_count": 32, 
              "followers_count": 64184, 
              "following": false, 
              "friends_count": 409, 
              "gender": "m", 
              "geo_enabled": true, 
              "id": 1058415305, 
              "location": "广东 广州", 
              "name": "行者孙冕", 
              "profile_image_url": "http://tp2.sinaimg.cn/1058415305/50/1279874506", 
              "province": "44", 
              "screen_name": "行者孙冕", 
              "statuses_count": 2269, 
              "url": "http://blog.sina.com.cn/sunmian", 
              "verified": true
          }
      }, 
      "source": "<a href=\"http://news.sina.com.cn/wap/wbclient.html#3\" rel=\"nofollow\">iPhone\u5ba2\u6237\u7aef</a>", 
      "text": "冕冕,加油!", 
      "truncated": false
  }, 
  "statuses_count": 2361, 
  "url": "http://blog.sina.com.cn/yaochen", 
  "verified": true

}

使用示例:

curl -u jkl0000@sina.cn:123456 -d "source=1481449075&user_id=1796213571" http://api.t.sina.com.cn/blocks/destroy.json