Authentication Methods for Web Services
Method | Description |
---|---|
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
<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
Parameter | Value | |
---|---|---|
Username | Web Service user name provided by RMC | MANDATORY |
Password | Web Service password provided by RMC | MANDATORY |
<?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>
<?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>
Error Parameters
Code | Error Message | Description |
---|---|---|
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! | Login information or the Service URL is incorrect. |
Logout
<logout> |
---|
Web servis isteği yapılmayacaksa, LOGIN ile açılmış oturumu sonlandırır. SERVICETICKET sona erdirilir. |
Parameters
Parameter | Value | |
---|---|---|
SERVICETICKET | session ID you want to end | MANDATORY |
<?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>
<?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>
Error Parameters
Code | Error Message | Detailed Message | Description |
---|---|---|---|
9998 | Unauthorized User! | Object reference not set to an instance of an object. | Logout failed. Invalid SERVICETICKET. |