注意事项

• 1、为确保应用及认证用户信息安全，此接口必须在服务器端调用；
• 2、调用接口的登录用户必须为当前应用的所有者，通过Base Auth的方式调用，详见type为text时的举例；
• 3、非常重要：此接口非短连接接口，需要以长连接方式调用，链接建立后有新的消息产生时每条完整的新消息数据以json形
  • 式返回，默认采用UTF-8编码，且以\r\n分隔；
• 4、非常重要：为缓解服务压力，请求建立后约每5分钟会自动断开（如未自动断开请用程序断开），需要保留最后一次获取的
  • 消息ID作为重新请求接口的since_id参数；
• 5、非常重要：当接收到的消息类型为text，且内容为“dy”或“td”时，分别表示“订阅”和“退订”；当接收到的消息类型为event，
  • 且subtype为“subscribe”或“unsubscribe”时，分别表示“订阅”和“退订”。
• 6、新消息来源用户也为认证用户且已开启消息服务时，新消息不推送；

调用举例

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

认证用户可接收的用户行为消息类型

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

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查看语音
    }
}

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

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

1，"USERNAME:PASSWORD"为"recipient_id"（认证用户）的微博登录用户名和密码，此时方法二中的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"
    }
}

// 默认仅返回可信用户的@，如需返回所有用户@，认证用户可访问此链接设置：http://account.weibo.com/set/message

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