1.简介

"通知服务"（约定为Notification的中文名称），是EbayAPI提供的一个便捷的工具，具有实时性的特点。

其设计思想基于发布-订阅模式。一旦客户端订阅了需要通知的事件，服务器发送通知时，客户端就实时接收从eBay发送的通知。

官网API文档：

http://developer.ebay.com/Devzone/guides/ebayfeatures/Notifications/Notifications.html 此文档应该是最好的第一手资料.

论坛帖子：

http://community.ebay.cn/thread-1200288175-1-1.html 此帖子比较全面.

.NET WebService接收例子：

https://ebaydts.com/eBayKBDetails?KBid=2112 直接可以拿过来用，主要是对SOAP消息接收的配置。

2.Usage

2.1流程描述

1）使用SetNotificationPreference接口去设定订阅的event type、通知地址（email或url）

2）如果选择Email，只需考虑收到邮件之后你将如何处理；

3）如果选择URL，则需要提供一个地址，如ebayapi.company.com的地址来接收，此处注意，端口号尽量使用80（8080和443没有试过，应该可以过），但是用了94，结果死活都收不到。问了ebay的技术，只能用默认端口。

4）当有订阅的event发生时，ebay会主动推送消息去你事先设定好的通知地址上。

2.2 设置接收地址

主要分为提醒邮箱设置、默认接收URL、指定URL（最多25个）三块。

依次分别是AlertEmail，ApplicationURL，DeliveryURLDetailType

1. [Test]
2. public void SetNotification_EnableOrDisable_ApplicaitonDelivery_Test()
3. {
4.     var context = ApiContextFactory.GetApiContext(token);
5.     //var context = SandBoxEnvironment.GetApiContextOfSendBox();
6.     SetNotificationPreferencesCall call = new SetNotificationPreferencesCall(context);
7.     var enable = EnableCodeType.Enable;
8.     var type = new ApplicationDeliveryPreferencesType()
9.     {
10.         AlertEmail = "mailto://1050244110@qq.com",
11.         AlertEnable = enable,
12.         AlertEnableSpecified = true,
13.         ApplicationURL = "mailto://1050244110@qq.com",
14.         ApplicationEnable = enable,
15.         ApplicationEnableSpecified = true,
16.         DeliveryURLDetails = new DeliveryURLDetailTypeCollection(
17.             new DeliveryURLDetailType[] {
18.             new DeliveryURLDetailType()
19.             {
20.                 Status = enable,
21.                 DeliveryURLName = "seller1_Delivery",
22.                 DeliveryURL = "http://address1.com",
23.                 StatusSpecified = true
24.             },new DeliveryURLDetailType(){
25.                     Status = enable,
26.                     DeliveryURLName = "seller2_Delivery",
27.                     DeliveryURL = "http://address2.com",
28.                     StatusSpecified = true
29.             }})
30.     };
31.     call.SetNotificationPreferences(type);
32. }

查看指定结果

1. [Test]
2. public void GetNotification_RoleCodeType_Application_Test()
3. {
4.     var context = ApiContextFactory.GetApiContext(token);
5.     //var context = SandBoxEnvironment.GetApiContextOfSendBox();
6.     GetNotificationPreferencesCall call = new GetNotificationPreferencesCall(context);
7.     call.GetNotificationPreferences(NotificationRoleCodeType.Application);
8.     Console.WriteLine(call.ApplicationDeliveryPreferences);
9.     Console.WriteLine(call.ApplicationDeliveryPreferences.AlertEmail);
10.     Console.WriteLine(call.ApplicationDeliveryPreferences.ApplicationURL);
11.     Console.WriteLine(call.ApplicationDeliveryPreferences.AlertEnable.ToString());
12.     Console.WriteLine(call.ApplicationDeliveryPreferences.ApplicationEnable.ToString());
13.     Console.WriteLine(call.ApplicationDeliveryPreferences.DeviceType.ToString());
14.     Console.WriteLine(call.ApplicationDeliveryPreferences.NotificationPayloadType.ToString());
15.     foreach (DeliveryURLDetailType item in call.ApplicationDeliveryPreferences.DeliveryURLDetails)
16.     {
17.         Console.WriteLine(item.DeliveryURL);
18.         Console.WriteLine(item.DeliveryURLName);
19.         Console.WriteLine(item.Status.ToString());
20.     }
21. }

2.3订阅EventType

1. [Test]
2. public void SetNotificationPreferences_EnableOrDisbable_EventTypes()
3. {
4.     var context = ApiContextFactory.GetApiContext(token);
5.     //var context = SandBoxEnvironment.GetApiContextOfSendBox();
6.     SetNotificationPreferencesCall call = new SetNotificationPreferencesCall(context);
7.     var enable = EnableCodeType.Enable;
8.     call.DeliveryURLName = "seller1_ Delivery "; //如果指定了，则使用对应名称的URL，反之，则使用 ApplicationURL
9.     var coll = new NotificationEnableTypeCollection();
10.     coll.Add(new NotificationEnableType()
11.     {
12.         EventEnable = enable,
13.         EventEnableSpecified = true,
14.         EventType = NotificationEventTypeCodeType.AuctionCheckoutComplete,
15.         EventTypeSpecified = true
16.     });
17.     coll.Add(new NotificationEnableType()
18.     {
19.         EventEnable = enable,
20.         EventEnableSpecified = true,
21.         EventType = NotificationEventTypeCodeType.FixedPriceTransaction,
22.         EventTypeSpecified = true
23.     });
24.     coll.Add(new NotificationEnableType()
25.     {
26.         EventEnable = enable,
27.         EventEnableSpecified = true,
28.         EventType = NotificationEventTypeCodeType.EndOfAuction,
29.         EventTypeSpecified = true
30.     });
31.     call.SetNotificationPreferences(coll);
32. }

查看订阅结果

1. [Test]
2. public void GetNotification_UserLevel_Test()
3. {
4.     var context = ApiContextFactory.GetApiContext(token);
5.     //var context = SandBoxEnvironment.GetApiContextOfSendBox();
6.     GetNotificationPreferencesCall call = new GetNotificationPreferencesCall(context);
7.     call.GetNotificationPreferences(NotificationRoleCodeType.User);
8.     Console.WriteLine(call.DeliveryURLName);
9.     Console.WriteLine(call.DetailLevelList.Count);
10.     foreach (NotificationEnableType item in call.UserDeliveryPreferenceList)
11.     {
12.         Console.WriteLine(item.EventEnable.ToString());
13.         Console.WriteLine(item.EventType.ToString());
14.     }
15. }

2.4 邮件接收结果截图

内容就是XML文档。

3.注意事项

3.1 端口

如果使用http或https的方式，端口号尽量使用默认端口号（80,443）

3.2 token

订阅某个卖家的EventType时，需要指定此卖家的token；

3.3 ApplicationDeliveryPreferencesType

当ApplicationDeliveryPreferencesType设置为Disable时，所有启用的订阅事件将不发送，除非将其又设置为Enable。