Flight Info Alerts - Completing your profile

Completing your Flight Info Alerts profile is a quick but important step to get started.

Once you have received confirmation of your Flight Info Alerts subscription, the next step is to complete your profile. Once you have completed your profile you will be provided with an Account ID and connection strings that are used to connect to your Microsoft Event Hub. During this process, OAG will spin up your OAG hosted Event Hub.

Completing your profile can be done via the Developer Portal using the 'Try It' functionality by following the below steps:

  • Navigate to the Complete Profile page here.
  • Click on the green Try It button.
  • Update your details in the body section as per the below example (replacing the word string with the appropriate values):
    {
    "firstName": "John",
    "lastName": "Smith",
    "email": "johnsmith@glaxowelcome.com",
    "content": "seats",
    "companyName": "GlaxoWelcome",
    "country": "GB"
    }
    Please note that requesting the "seats" content parameter on full subscriptions may come with additional charges as it is an optional add-on.
  • Click Send.

This process can take a few minutes as we are setting up your Microsoft Event Hub. Please do not refresh the screen until you have a response.

Alernatively, you may also create a HTTP POST request in the language or platform of your choice if you prefer not to use the Try It function on the developer portal. The details of how to do so can also be found on the Complete Profile page link indicated above.

The response will be returned in JSON with the following sample format:

{
"accountId": "028a183c-7392-40b7-9493-8f3214605wqd",
"evtPrimaryConnectionString": "sb://nsclienteu1g756784a.servicebus.windows.net/;SharedAccessKeyName=listenrule;SharedAccessKey=Q/uAPX5++aKPuIOAdasIkmf9GauahSFSGH+w=;EntityPath=eh3fb325632d",
"evtSecondaryConnectionString": "Endpoint=sb://nsclienteu1g756784a.servicebus.windows.net/;SharedAccessKeyName=listenrule;SharedAccessKey=wFSAvdaf+m312dSAFAHRg5pjaSASCAGc9uKrYEvs+M=;EntityPath=eh3fb325632d"
}

The JSON response contains 4 elements that should be noted for use with Flight Info Alerts:

  • Your account ID. This is very important and is used in all future API calls for creating, amending, retrieving and deleting your alerts.
  • Your primary connection string. This is used to connect to your Microsoft Event Hubs
  • Your secondary connection string. A back connection string used to connect to your Microsoft Event Hubs
  • Your event hub name. This is contained within both the connection strings as the value for EntityPath. In the example above, it is eh3fb325632d. You may be required to use this when interacting with the Event Hub.

If you misplace your account ID then please contact support@oag.com who will be able to provide it to you.

You now have everything you need to begin creating your Alerts.

Recommended next step: Creating an alert.