Skip to content
codesnik edited this page Jan 30, 2012 · 7 revisions

eviterra.com flight search api

version 0.04

api url:

https://eviterra.com/api/search.xml?arg1=value&arg2=value...

HTTP method - GET

url subjected to change in the nearest future, will issue notice about that.

arguments:

from IATA code of departure city/airport

to IATA code of arrival city/airport

date1 YYYY-MM-DD date of departure

date2 YYYY-MM-DD date of departure for a roundtrip journey. could be omitted

adults "1" if ommitted!

children "0" by default

infants "0" by default

cabin preferred booking class, could (and probably should) be omitted. "Y" for economy, "C" for business, "F" for first/premium. Empty by default (no preference)

partner your company identificator

format:

simple xml, no namespaces, no attributes (for now), just text elements

processing time:

Less than 60 seconds in current implementation. Less than 10 seconds average, so far

error reply:

HTTP 40x, 50x replies are possible and expected.

if 20x recieved, reply still could contain a single explanation text root element, or a...

successful reply structure:

/variants root element, for now. We going to change it in the future, with a prior notice, of course.

//variant structure:

//variant/price total price for all the passengers

//variant/url url to redirect customer to. See "Variant URL" section for details.

//variant/validatingCarrier IATA code of ticket issuing airline

//variant/segment - 1 elements for one way, 2 for roundtrip

//variant/segment/flight - 1..n, more than one if there're connecting points in the requested leg

//flight structure:

marketingCarrier airline IATA code (2 latin letters)

operatingCarrier airline IATA code (2 latin letters)

number 2..4 digits, almost always, full flight number is (marketingCarrier + number)

departure departure airport IATA code (3 latin letters)

departureRu departure airport russian domestic code, if present, 3 cyrillic letters

departureTerm departure airport terminal, if known. one or more latin or cyrillic letters

departureDate departure date, 'YYYY-MM-DD', local

departureTime departure time, 'HH:MM', local

arrival arrival airport IATA code (3 latin letters)

arrivalRu arrival airport russian domestic code, if present, 3 cyrillic letters

arrivalTerm arrival airport terminal, if known. one or more latin or cyrillic letters

arrivalDate arrival date, 'YYYY-MM-DD', local

arrivalTime arrival time, 'HH:MM', local

equipment IATA (or russian domestic) aircraft/bus/train equipment type code. several letters/digits

class booking class. could be almost any letter, latin or cyrllic

cabin cabin class. could be 'F' for 'first', 'C' for 'business', 'Y' for 'economy/couch'

Variant URL

it's assumed you redirect user browser to that url. It could contain significant for business logic anchor ("#..." part).

you can also add your tracking marker (string) to that url, for your internal tracking purposes. If there's anchor part, add marker after it. pseudocode illustration of the "guaranteed to work" way:

redirect_url = variant_url + '&marker=' + uri_escape(marker)

We'll return markers with our statistics in near future.