API整合-Webhook篇

继续回答前面 API整合-入门篇 这个问题：

Q4: 需要发给会员的邮件发送状态，以及邮件打开，点击等会员行为数据，还有会员客户端，访问地理位置等信息，这些数据要怎么能够获得？

我们先解释一下 Webhook：Webhook是一种消息订阅异步接口实现方式，它能够将用户订阅消息数据及时的传输到用户指定的位置（URL）。而灵动营销平台也提供这种接口，能够将用户订阅的邮件发送状态，用户的会员打开邮件，点击里面链接，更新会员信息等行为事件信息数据及时的传回用户业务系统。

下面灵动营销平台Webhook设置界面，订阅地址就是用户接送订阅数据的地址。

那么订阅数据是个什么样子，我们来看看下面这段文本，如果稍有点程序猿背景的同学，一眼就会看出。嗯，这是个JSON格式的数据，无论是对人还是对系统都比较容易理解。

//备注：下面示例数据在已经做了混淆:)
{
    \"delivered\": [
        {
            \"id\": 2201602002317593,
            \"campaign\": \"大麦网温馨提示：您关注的演出内容有更新\",
            \"email\": \"hg007@example.com\",
            \"status\": \"bounce:hard\",
            \"dsn\": \"Action: failed | Status: 5.1.2 (bad destination system: no such domain)\",
            \"updated\": \"2014-02-20 18:08:05\",
            \"createdAt\": \"2014-02-20 18:08:04\",
            \"scheduleId\": 17436,
            \"messageId\": 12399,
            \"contactId\": 19016004
        },
        {
            \"id\": 22201606019253710,
            \"campaign\": \"大麦网温馨提示：您关注的演出内容有更新\",
            \"uid\": \"GFpCmAhnXpPoXqXLH2BY\",
            \"email\": \" xiaorong@example.com \",
            \"status\": \"success\",
            \"dsn\": \"smtp;250 ok: Message 1758717523 accepted\",
            \"updated\": \"2014-06-27 15:03:04\",
            \"createdAt\": \"2014-06-27 15:02:20\",
            \"scheduleId\": 121830,
            \"messageId\": 162084,
            \"contactId\": 43001513
        }
    ],
    \"clicks\": [
        {
            \"id\": 22201603016582230,
            \"campaign\": \"大麦网温馨提示：您关注的演出内容有更新\",
            \"subject\": \"大麦网温馨提示：您关注的演出内容有更新\",
            \"uid\": \"GFpCmAhnXpPoXqXLH2BY\",
            \"email\": \"someone@example.com\",
            \"ip\": \"119.255.75.126\",
            \"location\": \"中国/河北/廊坊\",
            \"longitude\": 116.7139,
            \"latitude\": 39.5292,
            \"device\": \"\",
            \"platform\": \"Windows 7\",
            \"client\": \"Chrome\",
            \"url\": \"http://item.damai.cn/78982.html\",
            \"createdAt\": \"2014-02-20 18:08:05\"
        },
        {
            \"id\": 22201603026582230,
            \"campaign\": \"大麦网温馨提示：您关注的演出内容有更新\",
            \"subject\": \"大麦网温馨提示：您关注的演出内容有更新\",
            \"uid\": \"GFpCmAhnXpPoXqXLH2BY\",
            \"email\": \"someone@example.com\",
            \"ip\": \"119.255.75.126\",
            \"location\": \"中国/河北/廊坊\",
            \"longitude\": 116.7139,
            \"latitude\": 39.5292,
            \"device\": \"\",
            \"platform\": \"Windows 7\",
            \"client\": \"Chrome\",
            \"url\": \"#退订\",
            \"createdAt\": \"2014-02-20 18:08:05\"
        }
    ],
    \"opens\": [
        {
            \"id\": 222016111000001234,
            \"campaign\": \"大麦网温馨提示：您关注的演出内容有更新\",
            \"subject\": \"大麦网温馨提示：您关注的演出内容有更新\",
            \"uid\": \"GFpCmAhnXpPoXqXLH2BY\",
            \"email\": \"someone@example.com\",
            \"ip\": \"119.255.75.126\",
            \"location\": \"中国/河北/廊坊\",
            \"longitude\": 116.7139,
            \"latitude\": 39.5292,
            \"device\": \"\",
            \"platform\": \"Windows 7\",
            \"client\": \"Chrome\",
            \"createdAt\": \"2014-02-20 18:08:05\"
        }
    ],
    \"unsubscriptions\": [
        {
            \"id\": 222019111000001234,
            \"campaign\": \"大麦网温馨提示：您关注的演出内容有更新\",
            \"subject\": \"大麦网温馨提示：您关注的演出内容有更新\",
            \"uid\": \"GFpCmAhnXpPoXqXLH2BY\",
            \"email\": \"example@abc.com\",
            \"ip\": \"119.255.75.126\",
            \"location\": \"中国/河北/廊坊\",
            \"longitude\": 116.7139,
            \"latitude\": 39.5292,
            \"device\": \"\",
            \"platform\": \"Windows 7\",
            \"client\": \"Chrome\",
            \"source\": \"esp\",
            \"content\": \"I do not want to receive these emails anymore .\",
            \"createdAt\": \"2014-02-20 18:08:05\"
        }
    ],
    \"complaints\": [
        {
            \"id\": 222019111000005678,
            \"campaign\": \"KiKUU Order Shipped Reminder\",
            \"subject\": \"KiKUU Order Shipped Reminder\",
            \"uid\": \"65655dnvdte0\",
            \"email\": \"one@someone.com\",
            \"ip\": \"117.136.31.250\",
            \"location\": \"中国/广东省/广州市\",
            \"longitude\": 116.7139,
            \"latitude\": 39.5292,
            \"device\": \"\",
            \"platform\": \"Windows 7\",
            \"client\": \"Chrome\",
            \"source\": \"esp\",
            \"content\": \"在沒有任何解釋及通知的情況下, 退還按金時直接扣了大約27英鎊。在現場交還汽車時並沒有指出任何問題需要作出賠償，現在卻無理地少退還了按金。請協助跟進。\",
            \"createdAt\": \"2014-02-20 18:08:05\"
        }
    ]
}

如需了解更多关于API详细资料，请访问我们官网资源中心的『开发者』