2014年3月30日 (日) 08:11的版本

消息推送服务概述

当一个和认证用户相关的消息或者事件发生时（如某个用户向认证用户发送消息），微博服务器将POST消息数据包到开发者填写的URL上；

在开发者首次使用事件推送服务时，需要先通过一次校验来和微博服务器建立首次连接；微博服务器发送GET请求到开发者填写的URL上，校验参数如下表所示：

signature参数的加密规则为：将appsecret参数，timestamp参数，nonce参数进行字典排序后，将三个参数字符串拼接成一个字符串进行sha1加密；开发者收到请求后，首先通过加密后的signature参数来校验GET请求的真实性，如果确认此次GET请求来自微博服务器，原样返回echostr参数内容就可以成功建立首次连接，否则连接失败。

建立首次连接后，后续每次微博事件推送时也都会带上signature、timestamp、nonce三个参数，开发者依然可以通过对signature的校验判断此条消息的真实性。校验方式与首次建立连接一致。

接受消息推送

建立首次连接后，当认证用户有新消息时，微博消息推送服务会POST消息数据包到开发者填写的URL上，当前支持的消息类型：

（注意：需要对接收到的消息体type或subtype做兼容，当出现未知类型时可忽略此消息。）

事件消息：event

{
    "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",
        "ticket": "TICKET",
    }
}

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

{
    "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。

{
    "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。

{
    "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

{
    "result": true,
    "tpye": "text",
    "data":"{}"
}

当前支持回复的私信类型（type）中，data参数支持的参数：

<h3>纯文本类型私信消息：text</h3>
<pre>
{
    "text": "纯文本回复"
}

{
    "articles": [
        {
            "display_name": "两个故事",
            "summary": "今天讲两个故事，分享给你。谁是公司？谁又是中国人？​",
            "image": "http://storage.mcp.weibo.cn/0JlIv.jpg",
            "url": "http://e.weibo.com/mediaprofile/article/detail?uid=1722052204&aid=983319"
        },
        ... //最多支持8个图文，建议为1或3个
    ]
}

{
    "longitude": "116.308586",
    "latitude": "39.982525"
}