2/messages/v conversation
(以“=粉丝给蓝V发送一对一消息接口= 接口调用地址：https://m.api.weibo.com/2/messages/v_conversation.json HTTP请求方式：GET 是否需要登...”为内容创建页面) |
|||
| 第62行： | 第62行： | ||
==注意事项== | ==注意事项== | ||
| − | *1, 当前用户需要先完成[http://open.weibo.com/wiki/Scope Scope] | + | *1, 当前用户需要先完成[http://open.weibo.com/wiki/Scope Scope] 授权，对应的scope权限参数为：direct_messages_read； |
*2, 指定的uid用户为蓝V； | *2, 指定的uid用户为蓝V； | ||
*3, 指定的uid蓝V用户已设置成将自己的微博私信、留言等消息箱服务交给当前应用托管; | *3, 指定的uid蓝V用户已设置成将自己的微博私信、留言等消息箱服务交给当前应用托管; | ||
2013年7月22日 (一) 22:58的最后版本
粉丝给蓝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."
}
文档更新时间: 2013-07-22
