Direct messages/destroy batch
目录 |
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" } ]
其他
无