A lambda function that listens to an SNS topic, makes a call to the Nordics' Price and Availability ("Price & Avail") cache API and adds the results to a corresponding (DynamoDB) search bucket.
In order to use the caching features of the AWS API Gateway to cache requests made to the Nordics API, we need to create an API Gateway endpoint.
Instead of directly calling the NE API endpoint, we use the following setup:
This meant that we had to create an API Gateway endpoint to serve as the reverse-proxy.
at present this is pointing to the Denmark (sd
) endpoint for our MVP,
but when we roll-out to more markets it will be 5 minutes of API Gateway setup
(per NE region) and roughly 20 mins to map the URL query parameters for
other regions.
To run/develop/test this Lambda locally you will need a few Environment Variables.
We recommend you export these using an .env
file containing the following keys:
export API_GATEWAY_ENDPOINT=https://tc-jira.atlassian.net/browse/ISEARCH-218
export NE_API_KEY=https://tc-jira.atlassian.net/browse/ISEARCH-218
export NE_API_ENDPOINT=https://tc-jira.atlassian.net/browse/ISEARCH-218
export AWS_REGION=eu-west-1
export AWS_IAM_ROLE=arn:aws:iam::12345678:role/lambdafull
export AWS_ACCESS_KEY_ID=YOURKEY
export AWS_SECRET_ACCESS_KEY=SUPERSECRET
set the correct values ... if you get stuck ask!
When we request a list of trips with the following parameters:
{
adults: 2,
children: 3
}
This translates to the following API Path:
/trips?adults=2&children=3
Sample response (just one trip):
{
"result": [
{
"type": "UpdateTripInfo",
"marketUnitCode": "SD",
"departureCode": "BLL",
"destinationCode": "LPA",
"departureDate": "2016-08-24T00:00:00",
"vitsSerialNumber": "31",
"vitsClassCode": "E",
"hotelCode": "ALTA",
"hotelDuration": 21,
"duration": 22,
"roomTypeCode": "A22CLL",
"flightAllotment": 4,
"hotelProductCode": "GA",
"price": 34845,
"numberOfAdults": 2,
"numberOfChildren": 3,
"paxPrice": 7549,
"discountPrice": 0,
"discountTotal": 0,
"numberOfRooms": 2,
"priorityCode": 68,
"wvHotelPartId": 10861,
"preloadedPriceId": 315593779,
"boardCode": "N ",
"insertedDate": "2015-12-06T03:56:01.327",
"tripId": 59724601,
"flightInfo": {
"outFlight": [
{
"destinationCode": "LPA",
"departureStationCode": "BLL",
"serialNumber": "31",
"aircraftCode": "A321",
"carrierCode": "DK",
"flightTime": "0510",
"departureStationName": "Billund",
"destinationName": "Gran Canaria",
"carrierName": "Thomas Cook Airlines",
"classCode": "E",
"className": "Economy Class",
"airCraftName": "Airbus A321",
"destinationCountryCode": "ES",
"startTime": "0001-01-01T00:00:00",
"departureTime": "2016-08-24T08:20:00",
"arrivalTime": "2016-08-24T12:30:00",
"checkinTime": "2016-08-24T07:20:00",
"displayDepartureDateTime": "2016-08-24T08:20:00",
"destinationCountryName": "Spanien",
"departureCountryName": "Danmark"
}
],
"homeFlight": [
{
"destinationCode": "BLL",
"departureStationCode": "LPA",
"serialNumber": "31",
"aircraftCode": "A321",
"carrierCode": "DK",
"flightTime": "0450",
"departureStationName": "Gran Canaria",
"destinationName": "Billund",
"carrierName": "Thomas Cook Airlines",
"classCode": "E",
"className": "Economy Class",
"airCraftName": "Airbus A321",
"destinationCountryCode": "DK",
"startTime": "0001-01-01T00:00:00",
"departureTime": "2016-09-14T13:50:00",
"arrivalTime": "2016-09-14T19:40:00",
"checkinTime": "0001-01-01T00:00:00",
"displayDepartureDateTime": "2016-09-14T13:50:00",
"destinationCountryName": "Danmark",
"departureCountryName": "Spanien"
}
]
},
"roomTypeDescription": "2-værelses Club Room, lavt beliggende",
"boardCodeDescription": "Ingen måltider",
"available": true,
"indexedDate": "2015-12-06T04:01:44.5825643+01:00",
"tripUrl": "http://www.travel.net/redir/BookRedirect.aspx?departureDate=2016-08-24&duration=22&departureCode=BLL&destinationCode=LPA&transportSerial=31&transportClass=E&hotelCode=ALTA&roomType=A22CLL",
"isLastMinuteSale": false
}
]
}
Given a list of trips (from the trips API endpoint) we still need to lookup the Hotel details in order to get the photos, ratings, location, etc.
So, imagine that you searched the /trips
API endpoint for 2 adults and 3 children
(see above for result sample) you would then need to extract the HotelID
from the packages results and then make a request to the /hotels
endpoint
to get the additional data. in the NE API the hotel has the key: wvHotelPartId
e.g: "wvHotelPartId": 10861
/hotels?hotelIds=10861
{
"wvId": 10861,
"caId": 8857,
"name": "Altamar",
"description": "Altamar er verdens mest klassiske Spies-hotel. Her kan vi tilbyde særlige Simon Spies-suiter, som blandt andet er indrettet med festlige indslag fra Simon. Vi kan også tilbyde Spies Easy Travel, som gør din rejse nemmere.\n\nPå Altamar får du de perfekte rammer for familiens ferie sammen - intet mindre. Det er et efterspurgt og meget værdsat Family Garden, som ligger højt og roligt på en sydvendt bjergskråning lige uden for Puerto Rico med en storslået udsigt over havet. Her findes alt, hvad der skal til, for at hele familien får en dejlig og afslappet ferie: opvarmede pools i vinterhalvåret, en hyggelig restaurant samt lejligheder til op til 5 personer.",
"rating": {
"guestRating": 4.4,
"doubledRating": 7
},
"geographical": {
"countryId": 179,
"countryName": "Spanien",
"areaId": 108069,
"areaName": "Gran Canaria",
"resortId": 605,
"resortName": "Puerto Rico"
},
"location": {
"latitude": 27.7886658,
"longitude": -15.7194166
},
"url": "http://www.travel.net/de-kanariske-oer/puerto-rico/altamar",
"concept": {
"id": "familyGarden",
"title": "Family Garden"
},
"images": [
{
"url": "http://images1.travel.net/images/Hotel/LPAALTA1093_1_13.jpg?v=17",
"description": "",
"width": 696,
"height": 307
},
{
"url": "http://images1.travel.net/images/Hotel/LPAALTA1093_2_30.jpg?v=47",
"description": "Fra Altamar har du en fantastisk udsigt over Atlanterhavet",
"width": 1280,
"height": 853
},
{
"url": "http://images1.travel.net/images/Hotel/LPAALTA1093_3_15.jpg?v=17",
"description": "",
"width": 232,
"height": 131
},
{
"url": "http://images1.travel.net/images/Hotel/LPAALTA1093_4_14.jpg?v=17",
"description": "",
"width": 380,
"height": 215
}
],
"facts": [
{
"id": "OutdoorPool",
"name": "Pool",
"value": "2 stk."
},
{
"id": "DistanceToBeach",
"name": "Nærmeste strand",
"value": "1,5 km"
},
{
"id": "DistanceToCenter",
"name": "Nærmeste centrum",
"value": "500 m"
},
{
"id": "Bar",
"name": "Bar",
"value": "Ja"
},
{
"id": "ChildrenPool",
"name": "Børnepool",
"value": "Ja"
},
{
"id": "Elevator",
"name": "Elevator",
"value": "(kabelelevatorer som til tider kan være forstyrrende)"
},
{
"id": "PoolBar",
"name": "Poolbar",
"value": "Ja"
},
{
"id": 130,
"name": "Restaurant",
"value": "1"
},
{
"id": "MiniMarket",
"name": "Minimarked",
"value": "Ja"
},
{
"id": "CleaningDaysPerWeek",
"name": "Rengøring (antal dage pr. uge)",
"value": "5"
},
{
"id": "Internet",
"name": "Internet",
"value": "Mod betaling"
},
{
"id": "WaterSlide",
"name": "Vandrutsjebane",
"value": "Nej"
},
{
"id": "LolloAndBernie",
"name": "Lollo och Bernie",
"value": false
},
{
"id": "IsAdultHotel",
"name": "Adult hotel",
"value": false
},
{
"id": "AllInclusive",
"name": "All Inclusive",
"value": false
}
],
"hotelProduct": {
"id": 43,
"key": "FamilyGarden"
},
"interestProducts": [
{
"id": 61,
"key": "AllTypesOfInclusive"
},
{
"id": 85,
"key": "AllChildrensClub"
},
{
"id": 77,
"key": "FreeWiFi"
},
{
"id": 79,
"key": "WiFiAllOverHotel"
}
],
"importUpdateId": "2016-03-15T10:25:06.315Z"
}
Read: