Connection Guide

Registering to use the service
To obtain an login and password, please register here

Connecting to the service
Xml requests are submitted to as the body of an HTTP 1.1 POST request. You must connect using https (secure). Please see the general guidelines for information about our secondary system and correct handling of IPs, URLs and DNS.

In general, UTF-8 encoding should be used. The 'Content-Type' and 'Host' header must be submitted in the HTTP headers. GZip compression must be requested in all HTTP requests. (But please note that Travelfusion's servers may not always return gzip compressed results)

Example java and PHP code is supplied below which can be used to submit the login request to the Travelfusion service and obtain a response. You should insert your login and password into the appropriate place (highlighted in red) before executing this code. This code is supplied as guidance only and it is not necessarily functional or correct and is not recommended for use in any application. It is recommended that you consider connection problems very carefully. There are many reasons that a connection to our system may timeout or fail completely. You should detect these cases and implement retries wherever applicable/ safe to do so. 

Recommended Timeouts
The timeoutsbelow are examples / guidelines and are subject to the actual typicalresponse times seen at customer's end. 
Eachconnection to our service involves 2 steps: connection and read.These two steps have separate timeouts.

Connectiontimeouts:   (connect means opening the initial socket connection)
For all connections at any part of the search/ bookingflow, we recommend 2 seconds for the first attempt, retrying if theconnection fails, with increasing timeouts. Retry twice with timeoutsof 4 seconds and then 8 seconds respectively.

Data readtimeouts:   ('Data read' means the time from the successful socket opening, to the last byte of the response being read)
StartRouting:4s read timeout, retry once with a 15 seconds timeout
CheckRouting:7s read timeout (and continuewith the standard polling process in case of a time out)
StartBooking:20s read timeout, do NOT retry, instead proceed to CheckBooking
CheckBooking:10s read timeout (and continuewith the standard polling process in case of a time out)
ProcessDetails:120s read timeout, no retry
ProcessTerms:120s read timeout, no retry

We recommendcareful logging of the number and type of timeouts in all cases and aregular check of this data to ensure that timeout rates are low. Eachretry should be logged separately so that you can see how manytimeouts occur on the first attempt and how many on each of thesubsequent retries.