Skip to main content

Authorization

Follow this guide to create a new AviationStack credential that will allow Nexla to authenticate to and exchange data with the AviationStack API.
aviationstack_api_auth.png

AviationStack

Prerequisites​

The AviationStack API uses API key authentication. Each request is authenticated by appending your personal access key as the access_key URL query parameter. Before creating a credential in Nexla, retrieve your access key from the AviationStack dashboard using the steps below.

Obtain an AviationStack Access Key​

  1. Sign up for an AviationStack account at aviationstack.com, or sign in to an existing account.

  2. During registration, select a subscription plan that matches your usage requirements. AviationStack offers a free tier as well as several paid plans that unlock higher request volumes, HTTPS support, and additional endpoints (such as historical and future flight schedules).

    The Free Tier is restricted to HTTP requests. HTTPS support (required for most production integrations) is only available on the Basic plan and above. Review the AviationStack pricing page to confirm which plan unlocks the endpoints and protocol you need.

  3. Confirm your email address, and sign in to the AviationStack dashboard.

  4. From the dashboard, locate the API Access Key panel. Your personal API key is displayed in this panel and is used as the value of the access_key query parameter on every AviationStack request.

  5. Click the copy icon next to the key, and store the value securely. This key authenticates all requests made on behalf of your AviationStack account.

    Your access key can be regenerated at any time from the AviationStack dashboard. Regenerating the key invalidates the previous value, so any integrations using the old key will need to be updated.

Important

The AviationStack access key grants full access to the data and quota associated with your AviationStack subscription. Store it in a secure secret manager, never commit it to source control, and rotate it immediately if you suspect it has been exposed.

For complete information about authentication and request structure, see the AviationStack API documentation.

Create an AviationStack Credential​

  • To create a new AviationStack credential, after selecting the data source/destination type, click the Add Credential tile to open the Add New Credential overlay.

Credential Name & Description​

  1. Enter a name for the credential in the Credential Name field and a short, meaningful description in the Credential Description field.

    Resource descriptions are recommended but are not required. They should be used to provide information about the resource purpose, data freshness, etc. that can help the owner and other users efficiently understand and utilize the resource.

API Key​

  1. Enter your AviationStack access key in the API Key Value field. Nexla automatically appends this value as the access_key URL parameter on every request to the AviationStack API. The value is stored as a secret and is not displayed after the credential is saved.

    The access key is treated as a password. Use a dedicated key for the Nexla integration whenever possible so that the integration can be rotated independently of other AviationStack consumers.

Save the Credential​

  1. Once all of the relevant steps in the above sections have been completed, click the Save button at the bottom of the overlay to save the configured credential.

  2. The newly added credential will now appear in a tile on the Authenticate screen during data source/destination creation and can be selected for use with a new data source or destination.