Desktop Application . XML/SOAP web service interface . Help
Magrathea XML/SOAP Web service
 

The web service provides programmatic access to Magrathea Telecom's system using SOAP calls rather than Telnet calls. The benefit of this service is that it is far easier for programmers to use than working with sockets and telnet.

 

Diagram
 

This XML/SOAP based interface is available for you to use with your own web or desktop applications, providing an easy method for communicating with Magrathea Telecom.

 

Example
 

The following SOAP/XML call is made to the web service

<?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>
      <Allocate10 xmlns=\"www.magrathea-telecom.co.uk\">
         <username>username</username>
         <password>password</password>
         <phoneNumber>01353______</phoneNumber>
      </Allocate10>
   </soap:Body>
</soap:Envelope>

 and the web service returns the following packet of information

<?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>
      <Allocate10Response xmlns=\"www.magrathea-telecom.co.uk\">
         <Allocate10Result>
            <root>
               <CallStatus>
                  <ConnectionStatus>0</ConnectionStatus>
                  <ConnectionMessage>0135363494_ Range available</ConnectionMessage>
               </CallStatus>
            </root>
         </Allocate10Result>
      </Allocate10Response>
   </soap:Body>
</soap:Envelope>"

Calling the web service is a trivial matter for a programmer, but full example code will be supplied in C# if necessary.