Authentication web servisine ait aşağıdaki metodlar bulunmaktadır.
| Metod | Açıklama |
|---|---|
| Login | Webservis isteği yapılması için öncelikle Login metodu ile SERVICE TICKET alınmalıdır. |
| Logout | Herhangi bir web servis isteği yapılmayacaksa, sistemden çıkış için LOGOUT kullanılmalıdır. |
Login
<login> |
|---|
Web servis istekleri yapabilmek için, önce Login olunup bir ServiceTicket alınır. Bu ServiceTicket, her web servis isteğinde kullanılır. |
Parametreler
| Parametre | Değer | |
|---|---|---|
| Username | Related Marketing Cloud tarafından verilen web servis kullanıcı adı | ZORUNLU |
| Password | Related Marketing Cloud tarafından verilen web servis şifresi | ZORUNLU |
ÖRNEK REQUEST
<?xml version="1.0" encoding="utf-8"?> <soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <soap:Body> <Login xmlns="http://ws.euromsg.com/auth"> <Username>string</Username> <Password>string</Password> </Login> </soap:Body> </soap:Envelope>
ÖRNEK RESPONSE
<?xml version="1.0" encoding="utf-8"?> <soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema"> <soap:Body> <LoginResponse xmlns="http://ws.euromsg.com/auth"> <LoginResult> <Code>00</Code> <Message /> <DetailedMessage /> <ServiceTicket>3C860EC9BFF1B14BBF801</ServiceTicket> </LoginResult> </LoginResponse> </soap:Body> </soap:Envelope>
Başarılı istek durumunda
<Code> parametresi 00 olarak cevap döner.<ServiceTicket> değeri, yanlızca giriş başarılı olduğu durumda döner. Bu değer saklanılmalı ve diğer web servis ve web servis metodları için istek yapılmak istenildiğinde kullanılmalıdır.Hata Parametreleri
| Code | Message | DetailedMessage | Açıklama |
|---|---|---|---|
| 99 | Invalip IP | Web servis isteği gönderilen IP’nin web servis kullanıcısında tanımlı olmadığını ifade eder. | |
| 99 | No such user/password! | Kullanıcı bilgileri yada login olunmaya çalışılan servis URL’i hatalı olabilir. |
Logout
| <logout> |
|---|
Web servis isteği yapılmayacaksa, Login ile açılmış oturumu sonlandırır. ServiceTicket sona erdirilir. |
Parametreler
| Parametre | Değer | |
|---|---|---|
| ServiceTicket | Sonlandırılması istenilen oturum ID | ZORUNLU |
ÖRNEK REQUEST
<?xml version="1.0" encoding="utf-8"?> <soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <soap:Body> <Logout xmlns="http://ws.euromsg.com/auth"> <ServiceTicket>ABCDEFG</ServiceTicket> </Logout> </soap:Body> </soap:Envelope>
ÖRNEK RESPONSE
<?xml version="1.0" encoding="utf-8"?> <soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema"> <soap:Body> <LogoutResponse xmlns="http://ws.euromsg.com/auth"> <LogoutResult> <Code>00</Code> <Message /> <DetailedMessage /> </LogoutResult> </LogoutResponse> </soap:Body> </soap:Envelope>
Başarılı istek durumunda
<Code> parametresi 00 olarak cevap döner.Hata Parametreleri
| Code | Message | DetailedMessage | Açıklama |
|---|---|---|---|
| 9998 | Unauthorized User! | Object reference not set to an instance of an object. | Logout işlemi başarısız. <ServiceTicket> oturum değeri geçersiz. |