跳转到: 导航, 搜索

direct_messages/show_batch

根据私信ID批量获取私信内容

URL

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

支持格式

JSON

HTTP请求方式

GET

是否需要登录


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

访问授权限制

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

请求参数

  必选 类型及范围 说明
access_token true string 采用OAuth授权方式为必填参数,OAuth授权后获得。
dmids true string 需要查询的私信ID,用半角逗号分隔,一次最多50个。

注意事项

调用样例及调试工具

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://www.weibo007.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
        }
    },
    ...
]

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

返回字段说明

返回值字段 字段类型 字段说明
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}}}|中文]]




文档更新时间: 2011-06-15
api评价