Authentication Web Service


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  SERVICE TICKET using the Login method.

Logout

If no Web Service request will be done, you need to LOGOUT from the system.


To interact with any Web Services, developers must first use the Login method to create a SERVICE TICKET. Developers can send requests to other Web Service and methods using this SERVICE TICKET.


Login 

Back to Top ^ 

<login>

In order to make Web Service requests, you first need to LOGIN and create a  SERVICETICKET. This SERVICETICKET is used on every Web Service request.

Parameters

ParameterValue
UsernameWeb Service user name provided by RMC

MANDATORY

PasswordWeb Service password provided by RMC

MANDATORY

REQUEST EXAMPLE
<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
  <soap12:Body>
    <Login xmlns="http://ws.euromsg.com/auth">
      <Username>string</Username>
      <Password>string</Password>
    </Login>
  </soap12:Body>
</soap12:Envelope>
RESPONSE EXAMPLE
<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
  <soap12:Body>
    <LoginResponse xmlns="http://ws.euromsg.com/auth">
      <LoginResult>
        <ServiceTicket>string</ServiceTicket>
      </LoginResult>
    </LoginResponse>
  </soap12:Body>
</soap12:Envelope>
If the request was successful, the <CODE> parameter will return 00 as a response.
<SERVICETICKET> 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. <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!Login information or the Service URL is incorrect.



Logout 

Back to Top ^ 

<logout>

Ends the session started with LOGIN . SERVICETICKET is ended if no Web Service requests will be made.

Parameters

ParameterValue

SERVICETICKET

Session ID you want to end

MANDATORY

REQUEST EXAMPLE
<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
  <soap12:Body>
    <Logout xmlns="http://ws.euromsg.com/auth">
      <ServiceTicket>string</ServiceTicket>
    </Logout>
  </soap12:Body>
</soap12:Envelope>
RESPONSE EXAMPLE
<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
  <soap12:Body>
    <LogoutResponse xmlns="http://ws.euromsg.com/auth">
      <LogoutResult>
        <ServiceTicket>string</ServiceTicket>
      </LogoutResult>
    </LogoutResponse>
  </soap12:Body>
</soap12:Envelope>
If the request was successful, the <CODE> parameter will return 00 as a response.

Error Parameters

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

Logout failed. Invalid SERVICETICKET.



Parent Topic: SOAP Web Service


Copyright 2020 Related Digital