跳转到: 导航, 搜索

direct_messages/destroy

删除一条私信

URL

https://api.weibo.com/2/direct_messages/destroy.json

支持格式

JSON

HTTP请求方式

POST

是否需要登录


关于登录授权,参见 如何登录授权

访问授权限制

访问级别:高级接口(需要授权)
频次限制:
关于频次限制,参见 接口访问权限说明

请求参数

  必选 类型及范围 说明
access_token true string 采用OAuth授权方式为必填参数,OAuth授权后获得。
id true int64 需要删除的私信ID。

注意事项

只能删除当前登录用户自己的私信

调用样例及调试工具

API测试工具

返回结果

JSON示例

{
    "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,
        "status": {
            "created_at": "Tue May 24 18:04:53 +0800 2011",
            "id": 11142488790,
            "text": "我的相机到了。",
            "source": "<a href="http://weibo.com" rel="nofollow">新浪微博</a>",
            "favorited": false,
            "truncated": false,
            "in_reply_to_status_id": "",
            "in_reply_to_user_id": "",
            "in_reply_to_screen_name": "",
            "geo": null,
            "mid": "5610221544300749636",
            "annotations": [],
            "reposts_count": 5,
            "comments_count": 8
        }
    },
    "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
        "status": {
            "created_at": "Tue May 31 17:46:55 +0800 2011",
            "id": 11488058246,
            "text": "求关注。",
            "source": "<a href="http://weibo.com" rel="nofollow">新浪微博</a>",
            "favorited": false,
            "truncated": false,
            "in_reply_to_status_id": "",
            "in_reply_to_user_id": "",
            "in_reply_to_screen_name": "",
            "geo": null,
            "mid": "5612814510546515491",
            "annotations": [],
            "reposts_count": 8,
            "comments_count": 9
        }
    }
}

关于错误返回值与错误代码,参见 错误代码说明

返回字段说明

返回值字段 字段类型 字段说明
id int64 私信ID
created_at string 私信创建时间
text string 私信内容
send_type int 发送类型
sender_id int64 发送者UID
recipient_id int64 接收者UID
sender_screen_name string 发送者用户昵称
recipient_screen_name string 接收者用户昵称
mid int64 私信MID
status_id int64 转发的微博ID
sender object 发送者用户信息字段
recipient object 接收者用户信息字段

其他

相关问题

{{{relat_qa}}}


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


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




文档更新时间: 2022-02-09
api评价