direct_messages/user_list
获取与当前登录用户有私信往来的用户列表,与该用户往来的最新私信
URL
https://api.weibo.com/2/direct_messages/user_list.json
支持格式
JSON
HTTP请求方式
GET
是否需要登录
是
关于登录授权,参见 如何登录授权
访问授权限制
访问级别:高级接口(需要授权)
频次限制:是
关于频次限制,参见 接口访问权限说明
请求参数
必选 | 类型及范围 | 说明 | |
---|---|---|---|
access_token | true | string | 采用OAuth授权方式为必填参数,OAuth授权后获得。 |
count | false | int | 单页返回的记录条数,默认为20。 |
cursor | false | int | 返回结果的游标,下一页用返回值里的next_cursor,上一页用previous_cursor,默认为0。 |
注意事项
无
调用样例及调试工具
返回结果
JSON示例
{ "user_list": [ { "user": { "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 } }, "direct_message": { "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 } } }, ... ], "next_cursor": 20, "previous_cursor": 0, "total_number": 21 }
关于错误返回值与错误代码,参见 错误代码说明
返回字段说明
返回值字段 | 字段类型 | 字段说明 |
---|---|---|
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}}}
到 帮助中心 查看更多问题或提问
文档更新时间: 2022-01-25