Authentication Web Service

POST

Service URL	auth.asmx

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.

Geliştiricinin her hangi bir web servis ile etkileşime geçebilmesi için, öncelikle Login metodunu kullanarak bir SERVICE TICKET alması gerekir. Diğer web servis ve metodlarına yaratmış olduğu bu değer ile istekte bulunabilir.

Login

Back to Top ^

<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ı	MANDATORY
Password	Related Marketing Cloud tarafından verilen web servis şifresi	MANDATORY

Ö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>

ORNEK 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

Back to Top ^

<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	MANDATORY

ORNEK 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.