2/messages/v conversation

跳转到: 导航, 搜索

粉丝给蓝V发送一对一消息接口

接口调用地址:https://m.api.weibo.com/2/messages/v_conversation.json


HTTP请求方式:GET


是否需要登陆:是


频次限制:是


接口请求参数
参数名称 值的类型 是否必填 说明描述
access_token string true 采用OAuth授权方式为必填参数,其他授权方式不需要此参数,OAuth授权后获得。
uid int64 true 消息接收方蓝V用户ID。
since_id int64 false 若指定此参数,则返回ID比since_id大的微博(即比since_id时间晚的微博),默认为0。
max_id int64 false 若指定此参数,则返回ID小于或等于max_id的微博,默认为0。
count integer false 返回结果的条数数量,最大不超过200,默认为20。
page integer false 返回结果的页码,默认为1。
is_encoded integer false 返回结果是否转义。0:不转义,1:转义。默认1。需要转义的符号及转义规则见相关约束。

注意事项

  • 1, 当前用户需要先完成Scope 授权,对应的scope权限参数为:direct_messages_read;
  • 2, 指定的uid用户为蓝V;
  • 3, 指定的uid蓝V用户已设置成将自己的微博私信、留言等消息箱服务交给当前应用托管;
  • 4, 指定的uid蓝V用户已开启推送服务(当前托管即自动开启);
  • 5, 当前登录用户必须为uid蓝V用户的粉丝;

返回结果

// 成功返回
{
    "messages": [
        {
            "id": 1211260020031347, //私信ID,非receive或reply接口中的消息ID
            "type": "text",
            "recipient_id": 1902538057,
            "sender_id": 2489518277,
            "created_at": "Mon Jul 16 18:09:20 +0800 2012",
            "text": "您的余额还剩2元。",
            "data": {}
        }
    ],
    "next_cursor": 0,
    "previous_cursor": 0,
    "total_number": 66
}

// 失败返回
{
    "request": "/2/messages/v_conversation.json",
    "error_code": "264XX",
    "error": "error message."
}