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