Custom Connector
Swedavia Connector
Sweden
The Swedavia Connector provides access to real-time and historical flight information, airport details, and related services for Swedavia-operated airports. It supports departures and arrivals, OData flight queries, airport/airline metadata, destinations, parking, shops, restaurants, services, and wait times.
Overview
Integration Overview
This document provides a detailed guide for each integration point, its purpose, configuration, and workflow support using the Swedavia Connector.
- getDeparturesInfo / getArrivalsInfo. Departure or arrival information for an airport and date.
- getQuery. Queries flight information using an OData filter expression.
- getHeartbeat. Checks API availability (Swedavia internal use).
- get-airports / get-language / get-airlines. Lists airports, supported languages, and airline information.
- get-iata-destinations / parkinglots / shops / restaurants / services. Destinations, parking, shops, restaurants, and services for an airport.
- get-airports-airport / -flights. Projected airport wait times, and flight-specific wait times.
Documentation
Detailed Integration Documentation
Get Departures / Arrivals Info
| Action | getDeparturesInfo / getArrivalsInfo |
|---|---|
| Purpose | Retrieves departure or arrival flights for a specified airport and date — flight details, statuses, check-in (departures), and baggage (arrivals). |
| Configuration | Configure the connector with the correct base URL (https://api.swedavia.se). A subscription-key may be required. |
| Parameters | Required: airportIATA (e.g. ARN); date (YYYY-MM-DD); Accept header. Optional: subscription-key. |
| Output | Successful: JSON/XML with from/to airport details, numberOfFlights, and a flights array (flightId, airlineOperator, times, locationAndStatus, checkIn/baggage, remarks, diIndicator). Failure: 400 / 500. |
| Workflow example | Execute getDeparturesInfo with airportIATA=ARN and date=2025-05-09, then display flight details. |
Query Flights (OData)
| Action | getQuery |
|---|---|
| Purpose | Queries flight information using an OData filter expression — flexible retrieval by airport, type, date, or status. |
| Configuration | Configure the connector with the correct base URL (https://api.swedavia.se). A subscription-key may be required. Limit to one call per two seconds to avoid 429 errors. |
| Parameters | Required: Accept header. Optional: filter (e.g. airport eq ‘ARN’ and flightType eq ‘D’); continuationtoken (Base64); count (default 25, max 1000); subscription-key. |
| Output | Successful: JSON/XML with a flights array and a continuationtoken. Failure: 400 / 429 / 500. |
| Workflow example | Execute getQuery with filter=airport eq ‘ARN’ and flightType eq ‘D’, then page with continuationtoken. |
Airports, Languages & Airlines
| Action | get-airports / get-language / get-airlines |
|---|---|
| Purpose | Retrieves the list of Swedavia airports, supported languages, and airline information (filterable by airport or direction). |
| Configuration | Configure the connector with the correct base URL (https://api.swedavia.se). A subscription-key may be required. |
| Parameters | Optional: subscription-key. get-airlines also: airport (e.g. ARN); direction (arrival/departure). |
| Output | Successful: JSON with airport, language, or airline details. Failure: 400 / 500. |
| Workflow example | Execute get-airports to populate a selector, then get-airlines with airport=ARN and direction=departure. |
Airport Amenities & Destinations
| Action | get-iata-destinations / parkinglots / shops / restaurants / services |
|---|---|
| Purpose | Retrieves destinations served, parking lots, shops, restaurants, and services (lounges, Wi-Fi) for a specific airport, with language support. |
| Configuration | Configure the connector with the correct base URL (https://api.swedavia.se). A subscription-key may be required. |
| Parameters | Required: iata (e.g. ARN). Optional: langcode (default en); startMonth/endMonth/minimumDepartures (destinations); startDate/endDate (parking); subscription-key. |
| Output | Successful: JSON with destination, parking, shop, restaurant, or service details. Failure: 400 / 500. |
| Workflow example | Execute get-iata-shops and get-iata-restaurants with iata=ARN and langcode=en to enrich a traveler app. |
Wait Times (airport & flight)
| Action | get-airports-airport / get-airports-airport-flights |
|---|---|
| Purpose | Retrieves projected wait times for an airport (security/check-in), and wait-time information for specific flights. |
| Configuration | Configure the connector with the correct base URL (https://api.swedavia.se). A subscription-key may be required. |
| Parameters | Required: airport (e.g. ARN). Optional: flightid (e.g. SK007); date (RFC 3339); ConcurrencyVersion; subscription-key. |
| Output | Successful: JSON with wait-time details. Failure: 400 / 500. |
| Workflow example | Execute get-airports-airport with airport=ARN, then get-airports-airport-flights for a specific flight. |
Example Workflow: Airport Information & Flight Tracking
| Airport list | Use get-airports to identify a target (e.g. ARN). |
|---|---|
| Flight info | Use getDeparturesInfo and getArrivalsInfo with airportIATA=ARN and date=2025-05-09. |
| Flight query | Use getQuery with an OData filter, paging with continuationtoken. |
| Amenities & wait times | Use get-iata-shops/restaurants/services and get-airports-airport(-flights) to enrich the app. |
Use Case
A travel-tech startup integrates the Swedavia Connector with GCP to enhance its airport app. Using the API at api.swedavia.se, the app calls getDeparturesInfo and getArrivalsInfo for real-time flight data at ARN (Stockholm Arlanda), stored in BigQuery for analytics. getQuery with OData filters tracks specific flights, while get-iata-shops and get-iata-restaurants enrich the app with amenities. Wait-time data from get-airports-airport is processed in Cloud Functions to notify users — improving travel planning with real-time insights.
Support
For technical support, contact custom-connectors-support@isolutions.sa.