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