SOAP
things every developer should know
What is SOAP protocol?
SOAP (originally Simple Object Access Protocol) is a messaging protocol specification for exchanging structured information in the implementation of web services in computer networks. Its purpose is to induce extensibility, neutrality and independence. It uses XML Information Set for its message format, and relies on application layer protocols, most often Hypertext Transfer Protocol (HTTP) or Simple Mail Transfer Protocol (SMTP), for message negotiation and transmission. See more.
Using GZip compression
All the methods within Cangooroo API work with GZip Compression. It's important to use compression because it reduces the network traffic and the download time between our servers and your application.
Error structure
Our error structure follows the W3C specifications (view reference)
When occurs an error, Cangooroo WebService returns a HTTP status code 500.
Example of an error response:
<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" xmlns:tem="http://tempuri.org/"><soap:Body> <soap:Fault> <faultcode>soap:Client</faultcode> <faultstring>Err: Login_Fail - Invalid user or password.</faultstring> <faultactor>http://pp.cangooroo.net/CangoorooWeb/ws/2013/hotel_l.asmx</faultactor> <detail> <errorCode>1001</errorCode> <supportInfo>If necessary, please refer error token #213e1d48-d0b2-482e-b906-a36ddc0f8381</supportInfo> <errorAuxInfo>UserName: teste Password:WRONGPASS</errorAuxInfo> <faultDate>2013-07-21 10:30:17</faultDate> </detail> </soap:Fault></soap:Body></soap:Envelope>In case you encounter an error, remember to follow our Support's best practices to ensure we will be able to help you.
Tools
Below are some of the tools we recommend you use when it comes for Webservice integration, testing and providing us with all the information we might need to try and help you.
Please remember that we do not give any support to the tools below.