1.0.0 • Published 5 years ago

skiplagged-api-wrapper v1.0.0

Weekly downloads
4
License
MIT
Repository
github
Last release
5 years ago

skiplagged-node-api

A node.js wrapper for the Skiplagged API, forked from https://github.com/krishnaglick/skiplagged-node-api to upate the stale airport data.

Table of Contents

Installation

yarn add skiplagged-node-api

Variables

Variable NameDatatypeDescription
fromstringDeparture Airport IATA Code Required
tostringArrival Airport IATA Code Required
departureDatestringDeparture Date in YYYY-MM-DD format Required
returnDatestringReturn Date in YYYY-MM-DD format Optional
sortstringSort method: cost (default), duration, or path. Optional
resultsCountnumberNumber of desired results. 0 (All), 1 (default), 2, etc. Optional
partialTripsbooleantrue or false (Default). Toggles Skiplagged's "Get off the flight and leave the airport before the final destination". Optional

Usage

const flightScanner = require('skiplagged-node-api');
const flights = flightScanner(searchOptions);

Cheapest Flight

const flightScanner = require('skiplagged-node-api');

const searchOptions = {
  from: 'PDX',
  to: 'JFK',
  departureDate: '2018-02-01'
};

flightScanner(searchOptions).then(console.log);

Shortest Flight

const flightScanner = require('skiplagged-node-api');

const searchOptions = {
  from: 'PDX',
  to: 'JFK',
  departureDate: '2018-02-01',
  sort: 'duration'
};

flightScanner(searchOptions).then(console.log);

Least Layovers

const flightScanner = require('skiplagged-node-api');

const searchOptions = {
  from: 'PDX',
  to: 'JFK',
  departureDate: '2018-02-01',
  sort: 'path'
};

flightScanner(searchOptions).then(console.log);

Hidden City Flights

Hidden city ticketing occurs when a passenger disembarks an indirect flight at the connection node. Flight fares are subject to market forces, and therefore do not necessarily correlate to the distance flown. As a result, a flight between point A to point C, with a connection node at point B, might be cheaper than a flight between point A and point B. It is then possible to purchase a flight ticket from point A to point C, disembark at the connection node (B) and discard the remaining segment (B to C).

Using the hidden city tactic is usually practical only for one-way trips, as the airlines will cancel the subsequent parts of the trip once a traveler has disembarked. Thus, round-trip itineraries need to be created by piecing two one-way flights together. This tactic also requires that the traveler have carry-on luggage only, as any checked baggage items will be unloaded only at the flight's ticketed final destination.

Wikipedia

const flightScanner = require('skiplagged-node-api');

const searchOptions = {
  from: 'PDX',
  to: 'JFK',
  departureDate: '2018-02-01',
  partialTrips: true
};

flightScanner(searchOptions).then(console.log);

FAQ

  Q) I'm passing a return date but all that's changing is the price.
  A) The data returned by the api is not easy to interpret. The library I built this from did the parsing legwork, I've just done a refactor and maintenance pass. If you wish to try, feel free to open up a Pull Request.

  Q) Why was X feature removed?
  A) My design philosophy is one of data. A library should provide a number of pure functions and let me leverage them as I wish. Writing a small app to email the data, save it in a database, or text it is fairly easy in node-land.

License

The MIT License