Hackathon API

The Hackathon API is hosted — there is nothing to install and no database to copy. It gives you two things:

• A REST proxy to the easyJet holidays metasearch API and TripAdvisor. The upstream keys live on the server, so you never handle them.
• A GraphQL API over anonymised booking, customer satisfaction and member data, held in Cloudflare D1.

Set up your shell

Every example in these docs uses two variables. Set them once and the rest is copy-paste. Ask the organiser for both.

export API=https://api.easyjet-hackathon.uk
export KEY=the-key-everyone-shares

On Windows PowerShell:

$env:API = "https://api.easyjet-hackathon.uk"
$env:KEY = "the-key-everyone-shares"

Authenticate

Every request needs the shared key in an x-api-key header.

curl -H "x-api-key: $KEY" $API/api/geography

Without it you get a 401 that tells you which header is missing. Two things are exempt, because neither can send a header:

• /health, so you can check the server is up.
• The GraphiQL page itself, since a browser cannot attach a custom header when you navigate to a URL. The page loads with the key pre-filled, so the queries it sends do carry it. Requests for data on that same path are not exempt.

Check it works

/health needs no key and reports what the server loaded:

curl $API/health

{
  "ok": true,
  "tables": {
    "bookings": 100, "csat": 100, "members": 84,
    "destinations": 189, "destination_airports": 170,
    "hotels": 93, "hotel_images": 2685, "hotel_facility_items": 2013
  }
}

Those counts come from the database itself, so a missing or empty table shows up here before it confuses you in a query.

What is where

Open $API/graphql in a browser for GraphiQL, where you can explore the whole data schema and run queries without writing any code.