SWIM Service Discovery

This page serves as a central repository for resources related to the collaborative effort to develop and implement a SWIM (System Wide Information Management) Service Discovery capability. It provides access to key specifications, data models, schemas, and other relevant documents that facilitate the discovery and utilization of services across federated SWIM domains.

Developer Resources

API and Interface Definitions

SWIM Discovery Service (SDS) Implementation Specification, Version 2.0.0; FAA SWIM; July 2020

An updated version of the SDS Implementation Specification, designed to supersede Version 1.0.0. This document specifies the standard interface, key interaction patterns, schemas, and message exchange formats required to develop SWIM Discovery Services.

Status: Last Call for Comments

SWIM Discovery Service (SDS) Implementation Specification, Version 1.0.0; FAA SWIM; July 2020

A document that specifies a standard interface, key interaction patterns, schemas, and message exchange formats required to develop SWIM Discovery Services (SDS).

Status: Candidate Recommendation

SDS Version 1.0.0 OpenAPI schema

The API offered by SDS v. 1.0.0 that is compliant with OpenAPI Specification version 3.0.

Status: Candidate Recommendation

Data Models and Schemas

Service Description Model for JSON (SDM-J), Version 2.0.0

An updated version of the collection of JSON schemas based on the Service Description Conceptual Model (SDCM), designed to supersede Version 1.0.1.

Status: Last Call for Comments

Service Description Conceptual Model (SDCM) 3.0

A graphical and lexical representation of the properties, structure, and interrelationships of service metadata elements, forming the conceptual basis for the SWIM Discovery Service (SDS).

Status: Last Call for Comments

Service Description Model for JSON (SDM-J), Version 1.0.1

The collection of JSON schemas based on Service Description Conceptual Model(SDCM)

Status: Candidate Recommendation

SDS Representation JSON Schemas, Version 1.0

The collection of JSON schemas that together represent the information consumed or produced by a SWIM discovery service.

Status: Candidate Recommendation

Working Draft (WD): This is a preliminary document that is under active development. It's open for feedback and comments from the community.

Last Call for Comments (LCC): The document is nearing finalization and is seeking final feedback from the community before approval.

Candidate Recommendation (CR): The document developers believe the document is technically stable and ready for wider implementation. They seek feedback from the community to ensure broad support.

Proposed Recommendation (PR): The document has addressed feedback from the LCC stage and is nearing final approval.

Recommendation (REC): This is the final stage of document development. It indicates a consensus among community members and is considered best practice for future implementation.

Publications and Related Works

Proposal of Regional Candidate Standard for Service Discovery; The Eighth Meeting of System Wide Information Management Task Force (SWIM TF/8); Bangkok, Thailand, 08 – 10 November 2023

This paper proposes the SWIM Discovery Service (SDS) specification as a candidate standard for the APAC region.

SWIM Discovery Service Demonstration, Seventh Meeting of APAC SWIM Task Force (TF-7); FAA USA, KAC ROK; Civil Aviation Administration of China Air Traffic Management Bureau (ATMB), PRC; Electronic Navigation Research Institute (ENRI), Japan; May 2023

This paper describes SWIM Discovery Service (SDS) demonstration between ROK, USA, and Japan. It specifically provides capabilities to be used, topologies between SDS instances, and test-case for the demonstration.

SWIM Discovery Service (SDS) Update and Next Steps, Sixth Meeting of APAC SWIM Task Force (TF-6); FAA USA, KAC ROK; Civil Aviation Administration of China Air Traffic Management Bureau (ATMB), PRC; Electronic Navigation Research Institute (ENRI), Japan; May 2022

A working Paper that describes the status and plans of a growing collaborative effort to deploy a network of SWIM Discovery Services (SDS) in the Asia Pacific Region (APAC). The effort aims to support federated service discovery among independently developed and autonomously managed SWIM domains.

SWIM Discovery Service (SDS) Demonstration and Lessons Learned; Fifth Meeting of APAC SWIM Task Force (TF-5); FAA USA, KAC ROK; August 2021

A working Paper that provides a brief summary of the SDS concept, describes the SDS demonstration conducted at SWIM TF/5, and shares lessons learned from the SDS effort.

SWIM Discovery Service (SDS): Introduction; Federal Aviation Administration Fourth Meeting of APAC SWIM Task Force (TF-4); (FAA), USA, and Korea Airports Corporation (KAC), Republic of Korea (ROK); November 2020

A Working Paper that describes the enabling technologies and practices for instituting a SWIM Discovery Service.

Security and Trust in the Context of SWIM Service Discovery; Fourth Meeting of APAC SWIM Task Force (TF-4); FAA USA, KAC ROK; November 2020

A Working Paper that discusses options for securing SDS, and how the SDS effort can contribute to the establishment of a general SWIM security and trust framework for the APAC SWIM.

For questions regarding the content of this page contact Mark Kaplun (FAA)