Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

 

...

Authentication web servisine ait aşağıdaki metodlar bulunmaktadır.


General Information

Authentication Web Service includes necessary login and logout methods to execute Web Service requests. You must first  Login and get a  Service Ticket each time you would like to make a Web Service request or access other Web Service methods. 

Authentication Methods for Web Services



MethodDescription
Login

To make Web Service requests, you need to create a 

Status
subtletrue
colourRed
title Service Ticket
 alınmalıdır using the Login method.

Logout

Herhangi bir web servis isteği yapılmayacaksa, sistemden çıkış için If no Web Service request will be done, you need to 

Status
subtletrue
colourRed
titleLOGOUT
 kullanılmalıdır from the system.




Warning
iconfalse

Geliştiricinin her hangi bir web servis ile etkileşime geçebilmesi için, öncelikle Login metodunu kullanarak bir To interact with any Web Services, developers must first use the Login method to create a

Status
subtletrue
colourRed
title Service Ticket
 alması gerekir. Diğer web servis ve metodlarına yaratmış olduğu bu değer ile istekte bulunabilir.

Login 

. Developers can send requests to other Web Service and methods using this

Status
subtletrue
colourRed
title Service Ticket
.


Login 
Anchor
login
login

Back to Top ^ 

 

ÖRNEK REQUEST
 

<login>

 

Web servis istekleri yapabilmek için, önce

In order to make Web Service requests, you first need to

Status
subtletrue
colourRed
titleLogin

 olunup bir 

 and create a  

Status
subtletrue
colourRed
titleServiceTicket

 alınır

.

Bu

This

Status
subtletrue
colourRed
titleServiceTicket

, her web servis isteğinde kullanılır.

 

Parametreler

 

ParametreDeğer UsernameRelated Marketing Cloud tarafından verilen web servis kullanıcı adıZORUNLUPasswordRelated Marketing Cloud tarafından verilen web servis şifresiZORUNLU

is used on every Web Service request.

Parameters


ParameterValue
UsernameWeb Service user name provided by RMC

Status
colourGreen
titlemandatory

PasswordWeb Service password provided by RMC

Status
colourGreen
titlemandatory




 <
Code Block
languagexml
titleREQUEST EXAMPLE
linenumberstrue
<?xml version="1.0" encoding="utf-8"?> <soap:Envelope xmlns>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns xmlns:soapsoap12="http://schemaswww.xmlsoapw3.org/2003/05/soap/-envelope/"> <soap:Body> <Login xmlns>
  <soap12:Body>
    <Login xmlns="http://ws.euromsg.com/auth"> <Username>string</Username> <Password>string</Password> </Login> </soap:Body> </soap:Envelope>

 

ÖRNEK RESPONSE
 
>
      <Username>string</Username>
      <Password>string</Password>
    </Login>
  </soap12:Body>
</soap12:Envelope>



Code Block
languagexml
titleRESPONSE EXAMPLE
 <
<?xml version="1.0" encoding="utf-8"?
> <soap:Envelope xmlns:soap
>
<soap12:Envelope xmlns:xsi="http://
schemas
www.
xmlsoap
w3.org/
soap/envelope/" xmlns:xsi
2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema
-instance
"
 xmlns
 xmlns:
xsd
soap12="http://www.w3.org/2003/
2001
05/
XMLSchema"> <soap:Body> <LoginResponse xmlns
soap-envelope">
  <soap12:Body>
    <LoginResponse xmlns="http://ws.euromsg.com/auth"
> <LoginResult> <Code>00</Code> <Message /> <DetailedMessage /> <ServiceTicket>3C860EC9BFF1B14BBF801</ServiceTicket> </LoginResult> </LoginResponse> </soap:Body> </soap:Envelope> TipBaşarılı istek durumunda 
>
      <LoginResult>
        <ServiceTicket>string</ServiceTicket>
      </LoginResult>
    </LoginResponse>
  </soap12:Body>
</soap12:Envelope>


Tip
If the request was successful, the
Status
subtletrue
colourRed
title<Code>
 parametresi parameter will return
Status
subtletrue
colourRed
title00
 olarak cevap döner as a response.


Warning
Status
subtletrue
colourRed
title<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

 

CodeMessageDetailedMessageAçıklama99Invalip IP Web servis isteği gönderilen IP’nin web servis kullanıcısında tanımlı olmadığını ifade eder
 value is granted only after a successful login. This value must be saved and used to make requests for other web service and web service methods.
Status
subtletrue
colourRed
title<ServiceTicket>
expire time is two hours. But IIS can be recycle before this periot. if you received "No session" error; you can re-login and continue the process.

Error Parameters


CodeError MessageDescription
99Invalip IPInvalid Source IP. Your Source IP should be whitelisted by RMC Technical Client Support.
99No such user/password! Kullanıcı bilgileri yada login olunmaya çalışılan servis URL’i hatalı olabilir.
Logout 
Login information or the Service URL is incorrect.



Logout 
Anchor
logout
logout

Back to Top ^ 

<logout>
Web servis isteği yapılmayacaksa, 

Ends the session started with 

Status
subtletrue
colourRed
titleLogin

 ile açılmış oturumu sonlandırır

 

Status
subtletrue
colourRed
titleServiceTicket

 sona erdirilir.

Parametreler

 

ParametreDeğer ServiceTicketSonlandırılması istenilen oturum IDZORUNLU

 

ÖRNEK REQUEST
 

is ended if no Web Service requests will be made.

Parameters


ParameterValue

Status
subtletrue
colourRed
titleServiceTicket

Session ID you want to end

Status
colourGreen
titlemandatory



 <
Code Block
languagexml
titleREQUEST EXAMPLE
linenumberstrue
<?xml version="1.0" encoding="utf-8"?> <soap:Envelope xmlns>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns xmlns:soapsoap12="http://schemaswww.xmlsoapw3.org/2003/05/soap/-envelope/"> <soap:Body> <Logout xmlns>
  <soap12:Body>
    <Logout xmlns="http://ws.euromsg.com/auth"> <ServiceTicket>ABCDEFG</ServiceTicket> </Logout> </soap:Body> </soap:Envelope>

 

ÖRNEK RESPONSE
 
Code Block
languagexml
 <>
      <ServiceTicket>string</ServiceTicket>
    </Logout>
  </soap12:Body>
</soap12:Envelope>



Code Block
languagexml
titleRESPONSE EXAMPLE
linenumberstrue
<?xml version="1.0" encoding="utf-8"?> <soap:Envelope xmlns:soap>
<soap12:Envelope xmlns:xsi="http://schemaswww.xmlsoapw3.org/soap/envelope/" xmlns:xsi2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema-instance" xmlns xmlns:xsdsoap12="http://www.w3.org/2003/200105/XMLSchema"> <soap:Body> <LogoutResponse xmlnssoap-envelope">
  <soap12:Body>
    <LogoutResponse xmlns="http://ws.euromsg.com/auth"> <LogoutResult> <Code>00</Code> <Message /> <DetailedMessage /> </LogoutResult> </LogoutResponse> </soap:Body> </soap:Envelope>
Tip
Başarılı istek durumunda <Code> parametresi 00 olarak cevap döner.

Hata Parametreleri

 

CodeMessageDetailedMessageAçıklama
>
      <LogoutResult>
        <ServiceTicket>string</ServiceTicket>
      </LogoutResult>
    </LogoutResponse>
  </soap12:Body>
</soap12:Envelope>


Tip
If the request was successful, the 
Status
subtletrue
colourRed
title<Code>
 parameter will return 
Status
subtletrue
colourRed
title00
 as a response.

Error Parameters


CodeError MessageDetailed MessageDescription
9998Unauthorized User!Object reference not set to an instance of an object.

Logout

işlemi başarısız. <ServiceTicket> oturum değeri geçersiz.

failed. Invalid

Status
subtletrue
colourRed
titleServiceTicket
.




Parent Topic: SOAP Web Service