Flight Watchdog API

The Flight Watchdog API is a tool for daily flight price tracking. The flight tracking is defined by origin and destination, and a price limit. It sends you a notification, if it finds a lower price than defined.

Authorization

You will receive a token from us to use this API.

When you receive the token, use it in the request.

Authorization header example: Authorization: QWxhZGRpbjpPcGVuU2VzYW1l

How to test the credentials and the header authorization?

Try the index request described below.

AUTHORIZATIONAPI Key

Key

Authorization

Value

<value>

Create Watcher

Create a flight price tracking.

You can call the Create request until you reach the limit of watchers. The limit is set by Travelport CZ. After you reach the limit of watchers, your application should hide the customer input form. Then you can wait until some watchers are deleted and check it with /count-all. Or contact Travelport CZ to increase the limit.

When the attributecountis the same as the attributelimit, you've reached the limit of watchers.

Watchers are deleted manually or when the flight dates are in the past.

Parameters:

Name	Is required	Example	Description
origin	yes	`PRG`	IATA city code
destination	yes	`LON`	IATA city code
departure	yes	`2019-06-06`	ISO date
arrival	only for return flight	`2019-06-12`	ISO date
priceLimit	yes	`3000 CZK`	Price with currency code
email	yes	`customer@email.com`	Valid email
flightType	yes	`return`	`return` or `oneway`
lang	yes	`cs`	`cs`, `en`

Do not forget to delete all watchers created during your testing.

AUTHORIZATIONAPI Key

This folder is using API Key from collectionFlight Watchdog API

POSTCreate return flight Watcher

https://flight-watchdog-api.cee-systems.com/create

AUTHORIZATIONAPI Key

This request is using API Key from collectionFlight Watchdog API

HEADERS

Content-Type

application/json

Authorization

Basic ABCD1234

Bodyraw

{
    "origin": "PRG",
    "destination": "LON",
    "departure": "2019-06-07",
    "arrival": "2019-06-13",
    "priceLimit": "3000 CZK",
    "email": "customer@email.com",
    "flightType": "return",
    "lang": "cs"
}

Example Request

curl

curl --location 'https://flight-watchdog-api.cee-systems.com/create' \
--header 'Content-Type: application/json' \
--data-raw '{
    "origin": "PRG",
    "destination": "LON",
    "departure": "2018-11-23",
    "arrival": "2018-11-26",
    "priceLimit": "3000 CZK",
    "email": "customer@email.com",
    "flightType": "return",
    "lang": "cs"
}'

200 OK

Example Response

json

{
  "result": "Success",
  "message": "Created.",
  "context": {
    "limit": 100,
    "count": 1,
    "id": "315e5ba0-d6cc-11e8-a252-fdd6fb1ab92c"
  }
}

No response headers

This request doesn't return any response headers

POSTCreate oneway flight Watcher

https://flight-watchdog-api.cee-systems.com/create

AUTHORIZATIONAPI Key

This request is using API Key from collectionFlight Watchdog API

HEADERS

Content-Type

application/json

Authorization

Basic ABCD1234

Bodyraw

{
    "origin": "PRG",
    "destination": "LON",
    "departure": "2019-06-07",
    "priceLimit": "3000 CZK",
    "email": "customer@email.com",
    "flightType": "oneway",
    "lang": "cs"
}

Example Request

curl

curl --location 'https://flight-watchdog-api.cee-systems.com/create?test=missing-parameter' \
--header 'Content-Type: application/json' \
--data-raw '{
    "origin": "PRG",
    "destination": "LON",
    "departure": "2019-06-07",
    "arrival": "2019-06-13",
    "priceLimit": "3000 CZK",
    "email": "customer@email.com",
    "flightType": "return",
    "lang": "cs"
}'

200 OK

Example Response

json

{
  "message": "Missing parameter 'email'.",
  "result": "Error"
}

Access-Control-Allow-Credentials

Access-Control-Allow-Headers

Access-Control-Allow-Methods

Access-Control-Allow-Origin

Access-Control-Expose-Headers

Content-Encoding

gzip

Content-Type

text/html; charset=utf-8

Date

Wed, 05 Jun 2019 10:04:54 GMT

ETag

W/"ad-pOUI177P1NpjnX2+kiLFgA"

Server

nginx

Vary

Accept-Encoding

x-srv-span

v=1;s=a4a1a06eab6e7288

x-srv-trace

v=1;t=adc89b7d57e13983

Content-Length

141

Connection

keep-alive