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。 |
注意事项
无
调用样例及调试工具
返回结果
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 }
关于错误返回值与错误代码,参见 错误代码说明
返回字段说明
无
其他
无
相关问题
到 帮助中心 查看更多问题或提问