跳转到: 导航, 搜索

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为优先参数

调用样例及调试工具

API测试工具

返回结果

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}}}


帮助中心 查看更多问题或提问


Language: [[{{{2/uri}}}|中文]]




文档更新时间: 2022-02-09