Jieming (讨论 | 贡献)
(以“{{api_desc_v2| uri=direct_messages/destroy_batch| desc=根据私信ID或用户UID批量删除私信| httpMethod=POST| needAuth=是| level={{Api_L2}}| rateLimit=是| ...”为内容创建页面)
(以“{{api_desc_v2| uri=direct_messages/destroy_batch| desc=根据私信ID或用户UID批量删除私信| httpMethod=POST| needAuth=是| level={{Api_L2}}| rateLimit=是| ...”为内容创建页面)
2022年2月9日 (三) 11:20的最后版本
direct_messages/destroy_batch
根据私信ID或用户UID批量删除私信
URL
https://api.weibo.com/2/direct_messages/destroy_batch.json
支持格式
JSON
HTTP请求方式
POST
是否需要登录
是
关于登录授权,参见 如何登录授权
访问授权限制
访问级别:高级接口(需要授权)
频次限制:是
关于频次限制,参见 接口访问权限说明
请求参数
必选 | 类型及范围 | 说明 | |
---|---|---|---|
access_token | true | string | 采用OAuth授权方式为必填参数,OAuth授权后获得。 |
ids | false | string | 需要删除的私信ID,用半角逗号分隔,不超过20个。 |
uid | false | int64 | 用户UID,当为当前登录用户时,返回错误提示信息;当为其他用户的UID时,表示删除此UID与当前用户的全部对话。 |
注意事项
参数ids与uid二者必选其一,且只能选其一,且以ids为优先参数
调用样例及调试工具
返回结果
JSON示例
//uid参数 { "result": true } //ids参数 [ { "id": 2131786660, "created_at": "Thu May 26 09:26:55 +0800 2011", "text": "求互相关注!", "send_type": 0, "sender_id": 1073880650, "recipient_id": 1404376560, "sender_screen_name": "檀木幻想", "recipient_screen_name": "zaku", "mid": "1110526353950790", "status_id": 0, "sender": { "id": 1073880650, "screen_name": "檀木幻想", "name": "檀木幻想", "province": "11", "city": "5", "location": "北京 朝阳区", "description": "请访问微博分析家。", "url": "http://weibo.com/", "profile_image_url": "http://tp3.sinaimg.cn/1073880650/50/1285051202/1", "domain": "woodfantasy", "gender": "m", "followers_count": 723, "friends_count": 415, "statuses_count": 587, "favourites_count": 107, "created_at": "Sat Nov 14 00:00:00 +0800 2009", "following": true, "allow_all_act_msg": true, "remark": "", "geo_enabled": true, "verified": false, "allow_all_comment": true, "avatar_large": "http://tp3.sinaimg.cn/1073880650/180/1285051202/1", "verified_reason": "", "follow_me": true, "online_status": 0, "bi_followers_count": 199 }, "recipient": { "id": 1404376560, "screen_name": "zaku", "name": "zaku", "province": "11", "city": "5", "location": "北京 朝阳区", "description": "人生五十年,乃如梦如幻;有生斯有死,壮士复何憾。", "url": "http://blog.sina.com.cn/zaku", "profile_image_url": "http://tp1.sinaimg.cn/1404376560/50/0/1", "domain": "zaku", "gender": "m", "followers_count": 1204, "friends_count": 447, "statuses_count": 2908, "favourites_count": 0, "created_at": "Fri Aug 28 00:00:00 +0800 2009", "following": false, "allow_all_act_msg": false, "remark": "", "geo_enabled": true, "verified": false, "allow_all_comment": true, "avatar_large": "http://tp1.sinaimg.cn/1404376560/180/0/1", "verified_reason": "", "follow_me": false, "online_status": 0, "bi_followers_count": 215 } }, ... ]
关于错误返回值与错误代码,参见 错误代码说明
返回字段说明
无
其他
无
相关问题
{{{relat_qa}}}
到 帮助中心 查看更多问题或提问
文档更新时间: 2022-02-09