注意事项

• 1、为确保应用及V用户信息安全，此接口必须在服务器端调用；
• 2、调用接口的登录帐号为该appkey的所有者，需要使用所有者帐号通过Base Auth的方式；
• 3、如appkey已绑定IP地址，调用接口的请求IP须为绑定的IP；
• 4、指定的uid用户为蓝V；
• 5、指定的uid用户已设置成将自己的微博私信、留言等消息箱服务交给当前应用托管;
• 6、指定的uid用户已开启推送服务（当前托管即自动开启）;
• 6、每条完整的新消息数据以json形式返回，默认采用UTF-8编码，且以\r\n分隔；
• 7、新消息来源用户为蓝V且已开启消息服务时，新消息不推送；
• 8、为缓解服务压力，请求建立后约每5分钟会自动断开（如未自动断开请用程序断开），应用需兼容根据最后一次获取的新消息ID重新调此接口连接；

调用举例

curl -u "USERNAME:PASSWORD" "https://m.api.weibo.com/2/messages/receive.json?source=YOUR_APPKEY&uid=***" // "USERNAME:PASSWORD"为应用所有者用户名和密码

蓝V可接收的用户行为消息类型

连接建立后，当蓝V有新消息时，微博消息服务通过此连接向应用推送新消息，当前支持的消息类型：

1、事件消息：event

{
    "id": 1211260020031346,
    "type": "event",
    "recipient_id": 1902538057,
    "sender_id": 2489518277,
    "created_at": "Mon Jul 16 18:09:20 +0800 2012",
    "text": "事件消息",
    "data": {
        "subtype": "EVENT",
        "key": "EVENT_KEY"
    }
}

{
    "id": 1211260020031346,
    "type": "text",
    "recipient_id": 1902538057,
    "sender_id": 2489518277,
    "created_at": "Mon Jul 16 18:09:20 +0800 2012",
    "text": "私信或留言内容",
    "data": {}
}

{
    "id": 1211260020031347,
    "type": "image",
    "recipient_id": 1902538057,
    "sender_id": 2489518277,
    "created_at": "Mon Jul 16 18:09:20 +0800 2012",
    "text": "发了一张图片",
    "data": {
        "vfid": 821804459,     // 发送者用此ID查看图片
        "tovfid": 821804469    // 接收者用此ID查看图片
    }
}

查看（下载）图片
curl "https://upload.api.weibo.com/2/mss/msget?access_token=RECIPIENT_ACCESS_TOKEN&fid=TOVFID"

1，"RECIPIENT_ACCESS_TOKEN"：返回结果中接收者（recipient_id）通过OAuth2授权返回的access_token；
2，"TOVFID"：返回结果data字段中的tovfid。

{
    "id": 1211260020031347,
    "type": "position",
    "recipient_id": 1902538057,
    "sender_id": 2489518277,
    "created_at": "Mon Jul 16 18:09:20 +0800 2012",
    "text": "我在这里: http://t.cn/zQgLLYO",
    "data": {
        "longitude": "344.3344",
        "latitude": "232.343434"
      }
}

{
    "id": 1211260020031346,
    "type": "mention",
    "recipient_id": 1902538057,
    "sender_id": 2489518277,
    "created_at": "Mon Jul 16 18:09:20 +0800 2012",
    "text": "被@的微博或评论文本信息",
    "data": {
        "subtype": "MENTION_TYPE,
        "key": "MENTION_KEY"
    }
}

{
    "request": "/2/messages/receive.json",
    "error_code": "264XX",
    "error": "error message."
}