Services

In order to publish Service Descriptions and/or Service Definitions Service Editors will need to provide a JSON representation of them.

Such representation must respect specific JSON Schemas. In particular, two JSON Schemas have been defined:

• A Schema for Service Descriptions
• A Schema for Service Definitions

These Schemas have evolved during time and are maintained on this EUROCONTROL GitHub repository.

Service Description and Service Definition Schemas follow a pretty similar structure but present some differences reflecting their different nature and the requirements present in the different EUROCONTROL Specifications (EUROCONTROL-SPEC-168, EUROCONTROL-SPEC-195) to which they refer.

Therefore, they have been organized in such a way each of them refers to a same set of JSON Schema files where common types are defined.

So, currently, common type are described in the following schemas:

• common-types.json.schema.json file: It hosts common type definitions for objects like ServiceIdentification, ServiceGeneralDescription, ServiceInterface etc... This schema is currently at v1.0.0
• reference-code-types.schema.json file: It hosts code types reflecting the code lists as published at reference.swim.aero website. This schema is currently at v1.0.0  

Service Description and Service Definitions are defined in two separate Schemas:

• service-description.schema.json for Service Descriptions - This schema is currently at v3.0.0
• service-definition.schema.json for Service Definitions - This schema is currently at v3.0.0

For convenience, they are bundled in two different zip files attached:

• ServiceDefinition-Schemas.zip
• ServiceDescription-Schemas.zip