Weibo Platform Logo

微博开放平台

weibo

Direct messages/destroy batch

跳转到： 导航, 搜索
(→direct_messages/destroy_batch)
第1行： 第1行：
−
== direct_messages/destroy_batch ==
+
{{api_desc2|
−
批量删除当前登录用户的私信。出现异常时，返回HTTP400错误。
+
uri=direct_messages/destroy_batch|
−
 
+
desc=批量删除当前登录用户的私信。|
−
{{Api_url|direct_messages/destroy_batch}}
+
format=XML/JSON|
−
+
httpMethod=POST/DELETE|
−
{{Api_format|xml, json}}
+
needAuth=true|
−
 
+
rateLimit=true|
−
{{Api_req|POST|True|True}}
+
params={{api_args|ids|true|int64|想要删除私信的id，多个id之间用半角逗号分割，每次提交系统最多能接受20个私信ID。}}|
−
 
+
getParam=|
−
===请求参数===
+
postParam=-d "ids=722792861,630916457"|
−
*ids 必选参数，想要删除私信的id，多个id之间用半角逗号分割，支持最多20个。
+
result=
−
 
+
===XML示例===
−
 
+
<pre>
−
===返回结果===
+
<?xml version="1.0" encoding="UTF-8"?>
−
XML示例:
+
<direct_messages>
−
  <?xml version="1.0" encoding="UTF-8"?>
+
−
<direct_messages>
+
 
   <direct_message>
 
   <direct_message>
−
     <created_at>Fri Jan 08 15:15:31 +0800 2010</created_at>
+
     <created_at>Mon Dec 06 11:38:44 +0800 2010</created_at>
−
     <id>207675</id>
+
     <id>722792861</id>
−
     <text>send dm 777</text>
+
     <text>wahaha</text>
−
     <sender_id>10506</sender_id>
+
     <sender_id>1854740027</sender_id>
−
     <recipient_id>11075</recipient_id>
+
     <recipient_id>1854835127</recipient_id>
−
     <sender_screen_name>name_10506</sender_screen_name>
+
     <sender_screen_name>siegetest</sender_screen_name>
−
     <recipient_screen_name>name_11075</recipient_screen_name>
+
     <recipient_screen_name>siegetest2</recipient_screen_name>
 
     <sender>
 
     <sender>
−
       <id>10506</id>
+
       <id>1854740027</id>
−
       <screen_name>name_10506</screen_name>
+
       <screen_name>siegetest</screen_name>
−
       <name>name_10506</name>
+
       <name>siegetest</name>
−
       <province>0</province>
+
       <province>11</province>
−
       <city>0</city>
+
       <city>8</city>
−
       <location></location>
+
       <location>北京 海淀区</location>
−
       <description></description>
+
       <description>ABCDE</description>
−
       <url></url>
+
       <url/>
−
       <profile_image_url>http://tp3.sinaimg.cn/10506/50/0</profile_image_url>
+
       <profile_image_url>http://tp4.sinaimg.cn/1854740027/50/1291272213/1</profile_image_url>
−
       <domain>10506</domain>
+
       <domain/>
−
       <gender></gender>
+
       <gender>m</gender>
−
       <followers_count>24</followers_count>
+
       <followers_count>2</followers_count>
−
       <friends_count>50</friends_count>
+
       <friends_count>20</friends_count>
−
       <statuses_count>47</statuses_count>
+
       <statuses_count>18</statuses_count>
 
       <favourites_count>0</favourites_count>
 
       <favourites_count>0</favourites_count>
−
       <created_at>Thu Jan 01 08:00:00 +0800 1970</created_at>
+
       <created_at>Thu Nov 11 00:00:00 +0800 2010</created_at>
 
       <following>false</following>
 
       <following>false</following>
 
       <verified>false</verified>
 
       <verified>false</verified>
−
       <geo_enabled>false</geo_enabled>
+
       <allow_all_act_msg>false</allow_all_act_msg>
 +
      <geo_enabled>true</geo_enabled>
 
     </sender>
 
     </sender>
 
     <recipient>
 
     <recipient>
−
       <id>11075</id>
+
       <id>1854835127</id>
−
       <screen_name>name_11075</screen_name>
+
       <screen_name>siegetest2</screen_name>
−
       <name>name_11075</name>
+
       <name>siegetest2</name>
−
       <province>0</province>
+
       <province>11</province>
−
       <city>0</city>
+
       <city>8</city>
−
       <location></location>
+
       <location>北京 海淀区</location>
−
       <description></description>
+
       <description/>
−
       <url></url>
+
       <url/>
−
       <profile_image_url>http://tp4.sinaimg.cn/11075/50/0</profile_image_url>
+
       <profile_image_url>http://tp4.sinaimg.cn/1854835127/50/0/1</profile_image_url>
−
       <domain>11075</domain>
+
       <domain/>
−
       <gender></gender>
+
       <gender>m</gender>
−
       <followers_count>28</followers_count>
+
       <followers_count>0</followers_count>
−
       <friends_count>50</friends_count>
+
       <friends_count>20</friends_count>
−
       <statuses_count>29</statuses_count>
+
       <statuses_count>2</statuses_count>
 
       <favourites_count>0</favourites_count>
 
       <favourites_count>0</favourites_count>
−
       <created_at>Thu Jan 01 08:00:00 +0800 1970</created_at>
+
       <created_at>Thu Nov 11 00:00:00 +0800 2010</created_at>
 
       <following>false</following>
 
       <following>false</following>
−
       <verified>true</verified>
+
       <verified>false</verified>
−
       <geo_enabled>false</geo_enabled>
+
       <allow_all_act_msg>false</allow_all_act_msg>
 +
      <geo_enabled>true</geo_enabled>
 
     </recipient>
 
     </recipient>
 
   </direct_message>
 
   </direct_message>
−
...
+
   <direct_message>
−
   </direct_messages>
+
    <created_at>Mon Nov 15 10:43:48 +0800 2010</created_at>
−
JSON示例:
+
     <id>630916457</id>
−
<pre>
+
     <text>yl7sN</text>
−
[
+
     <sender_id>1854740027</sender_id>
−
  {
+
     <recipient_id>1854835127</recipient_id>
−
    "created_at":"Wed Jan 06 11:48:24 +0800 2010",
+
     <sender_screen_name>siegetest</sender_screen_name>
−
     "id":207568,
+
     <recipient_screen_name>siegetest2</recipient_screen_name>
−
     "text":"test",
+
     <sender>
−
     "sender_id":10506,
+
      <id>1854740027</id>
−
     "recipient_id":11075,
+
      <screen_name>siegetest</screen_name>
−
     "sender_screen_name":"name_10506",
+
      <name>siegetest</name>
−
     "recipient_screen_name":"name_11075",
+
      <province>11</province>
−
     "sender":
+
      <city>8</city>
−
          {"id":10506,
+
      <location>北京 海淀区</location>
−
            "screen_name":"name_10506",
+
      <description>ABCDE</description>
−
            "name":"name_10506",
+
      <url/>
−
            "province":null,
+
      <profile_image_url>http://tp4.sinaimg.cn/1854740027/50/1291272213/1</profile_image_url>
−
            "city":null,
+
      <domain/>
−
            "location":"",
+
      <gender>m</gender>
−
            "description":"",
+
      <followers_count>2</followers_count>
−
            "url":"",
+
      <friends_count>20</friends_count>
−
            "profile_image_url":"http://tp3.sinaimg.cn/10506/50/0",
+
      <statuses_count>18</statuses_count>
−
            "domain":"10506",
+
      <favourites_count>0</favourites_count>
−
            "followers_count":24,
+
      <created_at>Thu Nov 11 00:00:00 +0800 2010</created_at>
−
            "friends_count":50,
+
      <following>false</following>
−
            "statuses_count":0,
+
      <verified>false</verified>
−
            "favourites_count":25,
+
      <allow_all_act_msg>false</allow_all_act_msg>
−
            "created_at":"Thu Jan 01 08:00:00 +0800 1970",
+
      <geo_enabled>true</geo_enabled>
−
            "following":false,
+
     </sender>
−
            "geo_enabled":false,
+
    <recipient>
−
            "verified":false},
+
      <id>1854835127</id>
−
     "recipient":
+
      <screen_name>siegetest2</screen_name>
−
          {"id":11075,
+
      <name>siegetest2</name>
−
            "screen_name":"name_11075",
+
      <province>11</province>
−
            "name":"name_11075",
+
      <city>8</city>
−
            "province":null,
+
      <location>北京 海淀区</location>
−
            "city":null,
+
      <description/>
−
            "location":"",
+
      <url/>
−
            "description":"",
+
      <profile_image_url>http://tp4.sinaimg.cn/1854835127/50/0/1</profile_image_url>
−
            "url":"",
+
      <domain/>
−
            "profile_image_url":"http://tp4.sinaimg.cn/11075/50/0",
+
      <gender>m</gender>
−
            "domain":"11075",
+
      <followers_count>0</followers_count>
−
            "followers_count":28,
+
      <friends_count>20</friends_count>
−
            "friends_count":50,
+
      <statuses_count>2</statuses_count>
−
            "statuses_count":0,
+
      <favourites_count>0</favourites_count>
−
            "favourites_count":11,
+
      <created_at>Thu Nov 11 00:00:00 +0800 2010</created_at>
−
            "created_at":"Thu Jan 01 08:00:00 +0800 1970",
+
      <following>false</following>
−
            "following":false,
+
      <verified>false</verified>
−
            "geo_enabled":false,
+
      <allow_all_act_msg>false</allow_all_act_msg>
−
            "verified":true}
+
      <geo_enabled>true</geo_enabled>
−
  }
+
    </recipient>
−
...
+
  </direct_message>
−
]
+
</direct_messages>
 
</pre>
 
</pre>
−
{{param_DM}}
+
===JSON示例===
−
{{param_user}}
+
<pre>
 +
[
 +
    {
 +
        "sender_screen_name" : "siegetest",
 +
        "recipient_screen_name" : "siegetest2",
 +
        "text" : "yIKapZ",
 +
        "recipient" :
 +
        {
 +
            "name" : "siegetest2",
 +
            "domain" : "",
 +
            "geo_enabled" : true,
 +
            "followers_count" : 0,
 +
            "statuses_count" : 2,
 +
            "favourites_count" : 0,
 +
            "city" : "8",
 +
            "description" : "",
 +
            "verified" : false,
 +
            "id" : 1854835127,
 +
            "gender" : "m",
 +
            "friends_count" : 20,
 +
            "screen_name" : "siegetest2",
 +
            "allow_all_act_msg" : false,
 +
            "following" : false,
 +
            "url" : "",
 +
            "profile_image_url" : "http://tp4.sinaimg.cn/1854835127/50/0/1",
 +
            "created_at" : "Thu Nov 11 00:00:00 +0800 2010",
 +
            "province" : "11",
 +
            "location" : "北京 海淀区"
 +
        },
 +
        "sender" :
 +
        {
 +
            "name" : "siegetest",
 +
            "domain" : "",
 +
            "geo_enabled" : true,
 +
            "followers_count" : 2,
 +
            "statuses_count" : 18,
 +
            "favourites_count" : 0,
 +
            "city" : "8",
 +
            "description" : "ABCDE",
 +
            "verified" : false,
 +
            "id" : 1854740027,
 +
            "gender" : "m",
 +
            "friends_count" : 20,
 +
            "screen_name" : "siegetest",
 +
            "allow_all_act_msg" : false,
 +
            "following" : false,
 +
            "url" : "",
 +
            "profile_image_url" : "http://tp4.sinaimg.cn/1854740027/50/1291272213/1",
 +
            "created_at" : "Thu Nov 11 00:00:00 +0800 2010",
 +
            "province" : "11",
 +
            "location" : "北京 海淀区"
 +
        },
 +
        "sender_id" : 1854740027,
 +
        "recipient_id" : 1854835127,
 +
        "id" : 630904557,
 +
        "created_at" : "Mon Nov 15 10:40:45 +0800 2010"
 +
    },
 +
    {
 +
        "sender_screen_name" : "siegetest",
 +
        "recipient_screen_name" : "siegetest2",
 +
        "text" : "PGrTV6",
 +
        "recipient" :
 +
        {
 +
            "name" : "siegetest2",
 +
            "domain" : "",
 +
            "geo_enabled" : true,
 +
            "followers_count" : 0,
 +
            "statuses_count" : 2,
 +
            "favourites_count" : 0,
 +
            "city" : "8",
 +
            "description" : "",
 +
            "verified" : false,
 +
            "id" : 1854835127,
 +
            "gender" : "m",
 +
            "friends_count" : 20,
 +
            "screen_name" : "siegetest2",
 +
            "allow_all_act_msg" : false,
 +
            "following" : false,
 +
            "url" : "",
 +
            "profile_image_url" : "http://tp4.sinaimg.cn/1854835127/50/0/1",
 +
            "created_at" : "Thu Nov 11 00:00:00 +0800 2010",
 +
            "province" : "11",
 +
            "location" : "北京 海淀区"
 +
        },
 +
        "sender" :
 +
        {
 +
            "name" : "siegetest",
 +
            "domain" : "",
 +
            "geo_enabled" : true,
 +
            "followers_count" : 2,
 +
            "statuses_count" : 18,
 +
            "favourites_count" : 0,
 +
            "city" : "8",
 +
            "description" : "ABCDE",
 +
            "verified" : false,
 +
            "id" : 1854740027,
 +
            "gender" : "m",
 +
            "friends_count" : 20,
 +
            "screen_name" : "siegetest",
 +
            "allow_all_act_msg" : false,
 +
            "following" : false,
 +
            "url" : "",
 +
            "profile_image_url" : "http://tp4.sinaimg.cn/1854740027/50/1291272213/1",
 +
            "created_at" : "Thu Nov 11 00:00:00 +0800 2010",
 +
            "province" : "11",
 +
            "location" : "北京 海淀区"
 +
        },
 +
        "sender_id" : 1854740027,
 +
        "recipient_id" : 1854835127,
 +
        "id" : 620438135,
 +
        "created_at" : "Fri Nov 12 19:07:04 +0800 2010"
 +
    }
 +
]
 +
</pre>|
 +
useAge=
 +
* 如果提供的多个私信ID中只有一部分为有效的私信ID，则系统只删除这些有效的私信，并将被删除的这些私信以XML或者JSON格式返回。
 +
* 如果提供的多个私信ID均无效，则返回空结果集。对于XML格式，表现为一个封闭的<pre><direct_messages/></pre>标签，而对于JSON格式，则表现为一个空数组<pre>[]</pre>|
 +
otherInfo=无
 +
}}

2010年12月6日 (一) 14:11的版本

目录

direct_messages/destroy_batch

批量删除当前登录用户的私信。

URL

http://api.t.sina.com.cn/direct_messages/destroy_batch.(json%7Cxml)

支持格式

XML/JSON

HTTP请求方式

POST/DELETE

是否需要登录

true
关于授权机制，参见授权机制声明

请求数限制

true
关于请求数限制，参见接口访问权限说明

请求参数

  必选 类型及范围 说明
source true string 申请应用时分配的AppKey，调用接口时候代表应用的唯一身份。（采用OAuth授权方式不需要此参数）
ids true int64 想要删除私信的id，多个id之间用半角逗号分割，每次提交系统最多能接受20个私信ID。

注意事项

  • 如果提供的多个私信ID中只有一部分为有效的私信ID，则系统只删除这些有效的私信，并将被删除的这些私信以XML或者JSON格式返回。
  • 如果提供的多个私信ID均无效，则返回空结果集。对于XML格式，表现为一个封闭的
    <direct_messages/>
    标签，而对于JSON格式，则表现为一个空数组
    []

返回结果

XML示例

<?xml version="1.0" encoding="UTF-8"?>
<direct_messages>
  <direct_message>
    <created_at>Mon Dec 06 11:38:44 +0800 2010</created_at>
    <id>722792861</id>
    <text>wahaha</text>
    <sender_id>1854740027</sender_id>
    <recipient_id>1854835127</recipient_id>
    <sender_screen_name>siegetest</sender_screen_name>
    <recipient_screen_name>siegetest2</recipient_screen_name>
    <sender>
      <id>1854740027</id>
      <screen_name>siegetest</screen_name>
      <name>siegetest</name>
      <province>11</province>
      <city>8</city>
      <location>北京 海淀区</location>
      <description>ABCDE</description>
      <url/>
      <profile_image_url>http://tp4.sinaimg.cn/1854740027/50/1291272213/1</profile_image_url>
      <domain/>
      <gender>m</gender>
      <followers_count>2</followers_count>
      <friends_count>20</friends_count>
      <statuses_count>18</statuses_count>
      <favourites_count>0</favourites_count>
      <created_at>Thu Nov 11 00:00:00 +0800 2010</created_at>
      <following>false</following>
      <verified>false</verified>
      <allow_all_act_msg>false</allow_all_act_msg>
      <geo_enabled>true</geo_enabled>
    </sender>
    <recipient>
      <id>1854835127</id>
      <screen_name>siegetest2</screen_name>
      <name>siegetest2</name>
      <province>11</province>
      <city>8</city>
      <location>北京 海淀区</location>
      <description/>
      <url/>
      <profile_image_url>http://tp4.sinaimg.cn/1854835127/50/0/1</profile_image_url>
      <domain/>
      <gender>m</gender>
      <followers_count>0</followers_count>
      <friends_count>20</friends_count>
      <statuses_count>2</statuses_count>
      <favourites_count>0</favourites_count>
      <created_at>Thu Nov 11 00:00:00 +0800 2010</created_at>
      <following>false</following>
      <verified>false</verified>
      <allow_all_act_msg>false</allow_all_act_msg>
      <geo_enabled>true</geo_enabled>
    </recipient>
  </direct_message>
  <direct_message>
    <created_at>Mon Nov 15 10:43:48 +0800 2010</created_at>
    <id>630916457</id>
    <text>yl7sN</text>
    <sender_id>1854740027</sender_id>
    <recipient_id>1854835127</recipient_id>
    <sender_screen_name>siegetest</sender_screen_name>
    <recipient_screen_name>siegetest2</recipient_screen_name>
    <sender>
      <id>1854740027</id>
      <screen_name>siegetest</screen_name>
      <name>siegetest</name>
      <province>11</province>
      <city>8</city>
      <location>北京 海淀区</location>
      <description>ABCDE</description>
      <url/>
      <profile_image_url>http://tp4.sinaimg.cn/1854740027/50/1291272213/1</profile_image_url>
      <domain/>
      <gender>m</gender>
      <followers_count>2</followers_count>
      <friends_count>20</friends_count>
      <statuses_count>18</statuses_count>
      <favourites_count>0</favourites_count>
      <created_at>Thu Nov 11 00:00:00 +0800 2010</created_at>
      <following>false</following>
      <verified>false</verified>
      <allow_all_act_msg>false</allow_all_act_msg>
      <geo_enabled>true</geo_enabled>
    </sender>
    <recipient>
      <id>1854835127</id>
      <screen_name>siegetest2</screen_name>
      <name>siegetest2</name>
      <province>11</province>
      <city>8</city>
      <location>北京 海淀区</location>
      <description/>
      <url/>
      <profile_image_url>http://tp4.sinaimg.cn/1854835127/50/0/1</profile_image_url>
      <domain/>
      <gender>m</gender>
      <followers_count>0</followers_count>
      <friends_count>20</friends_count>
      <statuses_count>2</statuses_count>
      <favourites_count>0</favourites_count>
      <created_at>Thu Nov 11 00:00:00 +0800 2010</created_at>
      <following>false</following>
      <verified>false</verified>
      <allow_all_act_msg>false</allow_all_act_msg>
      <geo_enabled>true</geo_enabled>
    </recipient>
  </direct_message>
</direct_messages>

JSON示例

[
    {
        "sender_screen_name" : "siegetest",
        "recipient_screen_name" : "siegetest2",
        "text" : "yIKapZ",
        "recipient" : 
        {
            "name" : "siegetest2",
            "domain" : "",
            "geo_enabled" : true,
            "followers_count" : 0,
            "statuses_count" : 2,
            "favourites_count" : 0,
            "city" : "8",
            "description" : "",
            "verified" : false,
            "id" : 1854835127,
            "gender" : "m",
            "friends_count" : 20,
            "screen_name" : "siegetest2",
            "allow_all_act_msg" : false,
            "following" : false,
            "url" : "",
            "profile_image_url" : "http://tp4.sinaimg.cn/1854835127/50/0/1",
            "created_at" : "Thu Nov 11 00:00:00 +0800 2010",
            "province" : "11",
            "location" : "北京 海淀区"
        },
        "sender" : 
        {
            "name" : "siegetest",
            "domain" : "",
            "geo_enabled" : true,
            "followers_count" : 2,
            "statuses_count" : 18,
            "favourites_count" : 0,
            "city" : "8",
            "description" : "ABCDE",
            "verified" : false,
            "id" : 1854740027,
            "gender" : "m",
            "friends_count" : 20,
            "screen_name" : "siegetest",
            "allow_all_act_msg" : false,
            "following" : false,
            "url" : "",
            "profile_image_url" : "http://tp4.sinaimg.cn/1854740027/50/1291272213/1",
            "created_at" : "Thu Nov 11 00:00:00 +0800 2010",
            "province" : "11",
            "location" : "北京 海淀区"
        },
        "sender_id" : 1854740027,
        "recipient_id" : 1854835127,
        "id" : 630904557,
        "created_at" : "Mon Nov 15 10:40:45 +0800 2010"
    },
    {
        "sender_screen_name" : "siegetest",
        "recipient_screen_name" : "siegetest2",
        "text" : "PGrTV6",
        "recipient" : 
        {
            "name" : "siegetest2",
            "domain" : "",
            "geo_enabled" : true,
            "followers_count" : 0,
            "statuses_count" : 2,
            "favourites_count" : 0,
            "city" : "8",
            "description" : "",
            "verified" : false,
            "id" : 1854835127,
            "gender" : "m",
            "friends_count" : 20,
            "screen_name" : "siegetest2",
            "allow_all_act_msg" : false,
            "following" : false,
            "url" : "",
            "profile_image_url" : "http://tp4.sinaimg.cn/1854835127/50/0/1",
            "created_at" : "Thu Nov 11 00:00:00 +0800 2010",
            "province" : "11",
            "location" : "北京 海淀区"
        },
        "sender" : 
        {
            "name" : "siegetest",
            "domain" : "",
            "geo_enabled" : true,
            "followers_count" : 2,
            "statuses_count" : 18,
            "favourites_count" : 0,
            "city" : "8",
            "description" : "ABCDE",
            "verified" : false,
            "id" : 1854740027,
            "gender" : "m",
            "friends_count" : 20,
            "screen_name" : "siegetest",
            "allow_all_act_msg" : false,
            "following" : false,
            "url" : "",
            "profile_image_url" : "http://tp4.sinaimg.cn/1854740027/50/1291272213/1",
            "created_at" : "Thu Nov 11 00:00:00 +0800 2010",
            "province" : "11",
            "location" : "北京 海淀区"
        },
        "sender_id" : 1854740027,
        "recipient_id" : 1854835127,
        "id" : 620438135,
        "created_at" : "Fri Nov 12 19:07:04 +0800 2010"
    }
]

其他

无

来自“http://open.weibo.com/wiki/index.php?title=Direct_messages/destroy_batch&oldid=2781”

关于微博开放平台| 联系我们| 服务条款| 无线游戏| 开放平台官微

京网文 [2011] 0398-130号 京ICP证100780号 Copyright © 1996-2024 SINA