API Definition

Overview

Communication Protocol

The communication protocol between properties and GalapagosGDS API consists of HTTPS (HTTP Secure) transactions with embedded JSON documents. Note the following:

  • Only HTTPS posts to GalapagosGDS’s secure server are supported. Using HTTP will not work (GalapagosGDS API servers are not configured to accept posts over unsecured HTTP).
  • Communication is synchronous -- on the same socket, GalapagosGDS API reads the request and issues a positive or negative response, depending on whether GalapagosGDS API is able to process the request or not.
  • Content-Type of the HTTP Request Header should be: “text/JSON”.
  • Only connecting via our URLs is supported. GalapagosGDS does not support connection directly via IP Address, as this address is subject to change without notice. If the GalapagosGDS partner generally prefers IP Addresses for communication performance reasons, it may consider implementing an address caching strategy to reduce DNS lookups for the URLs. Additionally, if partner whitelists outbound connections, it must do so using a URL pattern rather than an IP range, as GalapagosGDS cannot guarantee a specific IP range / subnet.

Availability & Prices update Request (AU RQ)

AU RQ Schema Complete Definition

Legend: O = Optional

Level Element / @Attribute Data Type Number of occur. Description
0 boat number 1 Boat code for the api
0 cabin_type number 1 Cabin code for the api
0 departures array 1 Tour to be updated
1@departure_datedateanyDates on which promotion is applicable
1@arrival_datedateanyDates on which promotion is applicable
1@daysnumberanyDays from departure_date to which promotion is applicable
1@availablenumberanyTour's availability
1@holdnumberanyTour's sold
1@promotion_namestringanyName of the promotion
1@promotion_descriptionstringanyDescription of the promotion
1@adult_pricenumberanyAdult price to be updated
1@children_pricenumberanyChildren price to be updated
1@discount_typestringanyDiscount type for the promotion that can be %, $, -
1@promotion_typestringanyType of the promotion
1@promotion_policiesstringanyPolicies of the promotion