Transmission

In order for third party software providers to make the integration with Hotel-Spider as easy as possible two distincts transmission protocols have been implemented. All the communications from the third party software client to the Hotel-Spider server should be sent using HTTPS over a TCP/IP connection

1. HTTP POST RAW

Every programming language has its proper solution for transmitting XML as payload, please check the documentation for the appropriate usage. Disregarding which programming platform has been opted for, the following HTTP headers MUST be used to send XML to the Hotel-Spider servers.

Mandatory Headers

User-Agent: MyApplicationName
Content-Type: text/xml; charset=utf-8

User-Agent

Make sure to communicate the precise User-Agent your application will transmit when connecting to our server. Should this value NOT match with the value that is registered in our system, our Web-Application Firewall will BLOCK your request from reaching our servers.

2. SOAP

Most programming languages have a solution for building a SOAP client, please check the documentation for the appropriate usage. It is essential that a recognised SOAP client is used and NOT a homemade solution. Namespacing might evolve and this should not break your implementation.Disregarding which programming platform has been opted for, the following HTTP headers MUST be used to send XML to the Hotel-Spider servers.

Mandatory Headers

User-Agent: MyApplicationName

User-Agent

Make sure to communicate the precise User-Agent your application will transmit when connecting to our server. Should this value NOT match with the value that is registered in our system, our Web-Application Firewall will BLOCK your request from reaching our servers.

WSDL (Web Services Description Language) is an XML document that describes what a SOAP web service does—its methods, inputs, outputs, and endpoint URL.
It acts as a contract so clients know exactly how to call the service.

We have also output for the secure Endpoint if the SOAP interfaces need it.

Example: https://secure-api.hotel-spider.com/soap/ota/ideas?wsdl

Response will be:

<?xml version="1.0" encoding="utf-8"?>
<wsdl:definitions xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:tns="http://htng.org/2014A" xmlns:xs="http://www.w3.org/2001/XMLSchema" name="OTAService" targetNamespace="http://htng.org/2014A">
    <wsdl:import namespace="http://htng.org/2014A" location="LOCATION of WSDL"/>
    <wsdl:service name="OTAService">
        <wsdl:port name="OTA" binding="tns:OTABinding">
            <soap:address location="non-secure URL"/>
        </wsdl:port>
        <wsdl:port name="OTA_Secure" binding="tns:OTABindingSecure">
            <soap:address location="secure URL"/>
        </wsdl:port>
    </wsdl:service>
</wsdl:definitions>