注意事项

• 1、为确保应用及V用户信息安全，此接口必须在服务器端调用；
• 2、调用接口的登录帐号为该appkey的所有者，需要使用所有者帐号通过Base Auth的方式；
• 3、如appkey已绑定IP地址，调用接口的请求IP须为绑定的IP；
• 4、指定的uid用户为蓝V；
• 5、指定的uid用户已指定当前应用为其开发，且指定的uid用户已开启“开发模式”，详见：粉丝服务开发模式指南;
• 6、每条完整的新消息数据以json形式返回，默认采用UTF-8编码，且以\r\n分隔；
• 7、新消息来源用户为蓝V且已开启消息服务时，新消息不推送；
• 8、非常重要：此接口非短连接接口，需要以长连接方式调用；
• 9、非常重要：为缓解服务压力，请求建立后约每5分钟会自动断开（如未自动断开请用程序断开），应用需兼容根据最后一次
  • 获取的新消息ID重新调此接口连接。

调用举例

curl -u "USERNAME:PASSWORD" "https://m.api.weibo.com/2/messages/receive.json?source=YOUR_APPKEY&uid=***" 
// "USERNAME:PASSWORD"为应用所有者用户名和密码（注意不是uid蓝V的，除非应用所有者和uid为同一用户）

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

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

1、事件消息：event

{
    "id": 1211260020031346,
    "type": "event",
    "receiver_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",
    "receiver_id": 1902538057,
    "sender_id": 2489518277,
    "created_at": "Mon Jul 16 18:09:20 +0800 2012",
    "text": "私信或留言内容",
    "data": {}
}

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

{
    "id": 1211260020031347,
    "type": "voice",
    "receiver_id": 1902538057,
    "sender_id": 2489518277,
    "created_at": "Mon Jul 16 18:09:20 +0800 2012",
    "text": "发了一个语音消息",
    "data": {
        "vfid": 821804459,    // 发送者用此ID查看语音
        "tovfid": 821804469  // 接收者用此ID查看语音
    }
}

查看（下载）蓝V接收到的语音方法一
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。

查看（下载）蓝V接收到的语音方法二
curl -u "USERNAME:PASSWORD" "https://upload.api.weibo.com/2/mss/msget?source=APPKEY&fid=TOVFID"

1，"USERNAME:PASSWORD"为"recipient_id"（蓝V）的微博登录用户名和密码，此时方法二中的APPKEY应用所有者为"recipient_id"；
2，"TOVFID"：返回结果data字段中的tovfid。

{
    "id": 1211260020031347,
    "type": "image",
    "receiver_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"：返回结果中接收者（receiver_id）通过OAuth2授权返回的access_token；
2，"TOVFID"：返回结果data字段中的tovfid。

{
    "id": 1211260020031346,
    "type": "mention",
    "receiver_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."
}