SOAP הוא תקן ותיק של שירותי רשת: שולחים בקשות ב-XML (בתוך "מעטפת SOAP") דרך HTTPS, והשרת עונה ב-XML. לאקטיב טרייל יש שני שירותי SOAP:
שירות Messaging
כתובת בסיס: https://webapi.mymarketing.co.il/Messaging/MessagingService.asmx
לשליחת מיילים טרנזקציוניים ולפעולות שליחה נוספות שהשירות מציע.
שירות Customers
כתובת בסיס: https://webapi.mymarketing.co.il/Customers/CustomerService.asmx
לפעולות על נמענים, כמו שאילתות אישור והסרה (בהתאם למתודה שקוראים לה).
פתחו כתובת בסיס בדפדפן כדי לראות את התיעוד של השירות ואת המתודות שלו.
קודם מתחברים
לפני כל קריאה ל-SOAP API צריך לשלוח בקשת התחברות נפרדת עם שם המשתמש והסיסמה. המתודה Login מפיקה טוקן חדש בכל פעם, לפני הקריאה שרוצים לבצע.
שגיאה: Not authorized
אם מתקבלת השגיאה הזו, ההתחברות נכשלה או שלא נשלחה:
System.Web.Services.Protocols.SoapException: Server was unable to process request. ---> ActiveTrail.BusinessLogic.Web.API.Core.MyMarketingException: Error generating security token ---> System.ApplicationException: Not authorized.
at ActiveTrail.BusinessLogic.Web.API.SessionManager.LoginUser(String username, String password) …קראו ל-Login עם שם המשתמש והסיסמה לפני כל בקשה.
על ה-REST API, ראו תחילת עבודה עם ה-API של אקטיב טרייל.