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详细资料，请访问我们官网资源中心的『开发者』
