跳转到: 导航, 搜索

direct_messages/conversation

获取与指定用户的往来私信列表

URL

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

支持格式

JSON

HTTP请求方式

GET

是否需要登录


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

访问授权限制

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

请求参数

  必选 类型及范围 说明
access_token true string 采用OAuth授权方式为必填参数,OAuth授权后获得。
uid true int64 需要查询的用户的UID。
since_id false int64 若指定此参数,则返回ID比since_id大的私信(即比since_id时间晚的私信),默认为0。
max_id false int64 若指定此参数,则返回ID小于或等于max_id的私信,默认为0。
count false int 单页返回的记录条数,默认为50。
page false int 返回结果的页码,默认为1。

注意事项

调用样例及调试工具

API测试工具

返回结果

JSON示例

{
    "direct_messages": [
        {
            "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
            }
        },
        ...
    ],
    "previous_cursor": 0,
    "next_cursor": 1364866035,
    "total_number": 33
}

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

返回字段说明

返回值字段 字段类型 字段说明
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-02-09