跳转到: 导航, 搜索

direct_messages/public/messages

获取当前登录用户消息箱的留言消息接收列表

URL

https://api.weibo.com/2/direct_messages/public/messages.json

支持格式

JSON

HTTP请求方式

GET

是否需要登录


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

访问授权限制

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

请求参数

  必选 类型及范围 说明
access_token true string 采用OAuth授权方式为必填参数,OAuth授权后获得。
count false integer 返回结果的条数数量,最大不超过200,默认为20。
page false integer 返回结果的页码,默认为1。
since_id false int64 若指定此参数,则返回ID比since_id大的消息(即比since_id时间晚的消息),默认为0。
max_id false int64 若指定此参数,则返回ID小于或等于max_id的私信,默认为0。

注意事项

调用样例及调试工具

API测试工具

返回结果

JSON示例

{
    "direct_messages": [
        {
            "id": 3603075032341769,
            "idstr": "3603075032341769",
            "created_at": "Tue Jul 23 04:04:52 +0800 2013",
            "text": "你好,今天是你的达人好友:@我***.. 的生日哦",
            "sender_id": 19809200000,
            "recipient_id": 190250000000,
            "sender_screen_name": "李四",
            "recipient_screen_name": "张三",
            "sender": {
                // user字段信息
            },
            "recipient": {
                // user字段信息
            },
            "mid": "3603075032341769",
            "source": "<a href=\"http://weibo.com/\" rel=\"nofollow\">新浪微博</a>",
            "status_id": 0,
            "geo": null,
            "dm_type": 2,
            "media_type": 0
        },
        ...
    ],
    "total_number": 10
}

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

返回字段说明

其他

相关问题


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


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




文档更新时间: 2013-07-24
api评价