跳转到: 导航, 搜索

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。

注意事项

调用样例及调试工具

API测试工具

返回结果

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}}}


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


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




文档更新时间: 2022-01-25