service definitions
Access the Prototype
- WILSON Scott
The Prototype provides two means to access the service:
- HMI - an "AeronauticalDatasetClient" that works in a web browser
- API - a B2B interface
Both methods are documented here.
Access via HMI
Important
In order to access:
- You must have an account in the TEST LDAP (https://ext-test.eurocontrol.int).
- A security certificate must be installed on the web browsers(s). Please contact aim@eurocontrol.int in order to get the certificate and further instructions about it.
Connect to the following web site using a Web browser: EUROCONTROL "AeronauticalDatasetClient" Prototype
The following picture shows one of the screens of the Eurocontrol Prototype, This example of a possible client application, working within a Web browser, interacts in fact with the service through the B2B service interfaces, which are implemented as specified in the Service Definition.
It shall be well understood that the client application functionality and human interface are not part of the service description! The prototype HMI is provided only in order to help understanding the service functionality, without the need to develop a client application.
Access via API
REST interface
Important
In order to access:
- You must have an account in the TEST LDAP (https://ext-test.eurocontrol.int).
- A security certificate must be installed on the local application. This also applies in the case that a web browser is used for the REST calls described here. Please contact aim@eurocontrol.int in order to get the certificate and further instructions about it.
The prototype service may be accessed through a REST interface. The Swagger documentation provided below contains further details.
Example calls
In order to get airports, the following call is used:
In order to get all non-AIRAC datasets, the following call is used:
datasets
The complete list of parameters in this case is:
- https://ext-test.eurocontrol.int:10444/aeronautical_dataset/datasets?
- airacUpdate=
- &airportDesignators=
- &airportNames=
- &airportsIataCodes=
- &airportsIds=
- &airspaceDesignators=
- &airspaceNames=
- &airspaceTypes=
- &airspacesIds=
- &countriesCode=
- &countriesIds=
- &countriesName=
- &dataSubjectIds=
- &datasetSeriesId=
- &datasetSeriesTitle=
- &dpsFileId=
- &effectiveDate=
- &encodingId=
- &endValidity=
- &limitationOnUse=
- &operatorEffectiveDate=
- &operatorPublicationDate=
- &publicationDate=
- &title=
- &typeId=
- &updateTypeId=
API documentation generation
Generate from provided JSON file
You can use the following steps to generate your own documentation and client
- use this JSON file: api-docs-for_external.json
- use this website: https://editor.swagger.io/
- upload the JSON file in the website and generate a client for the application (Java, Javascript, …).
There are a lot of possibilities with swagger to generate a client. You can find all the possibilities on the official documentation : https://swagger.io/tools/swagger-codegen/
Generate from scratch
You can regenerate the JSON file following this URL
If you use this URL to generate the JSON you will notice the host is set as : webprisme-test.cfmu.eurocontrol.int. You should change it to ext-test.eurocontrol.int:10444