{"id":30743462,"url":"https://github.com/ukho/exchange-set-service","last_synced_at":"2025-09-04T02:07:27.533Z","repository":{"id":39533784,"uuid":"339742375","full_name":"UKHO/exchange-set-service","owner":"UKHO","description":"ADDS Exchange Set Service","archived":false,"fork":false,"pushed_at":"2025-08-12T13:52:03.000Z","size":25055,"stargazers_count":7,"open_issues_count":0,"forks_count":1,"subscribers_count":12,"default_branch":"main","last_synced_at":"2025-08-12T15:37:31.802Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/UKHO.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":"CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2021-02-17T14:03:24.000Z","updated_at":"2025-08-11T11:47:48.000Z","dependencies_parsed_at":"2024-03-27T13:31:56.191Z","dependency_job_id":"a39847bb-92bd-4923-aa3d-da5cc9f3258b","html_url":"https://github.com/UKHO/exchange-set-service","commit_stats":null,"previous_names":[],"tags_count":30,"template":false,"template_full_name":null,"purl":"pkg:github/UKHO/exchange-set-service","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/UKHO%2Fexchange-set-service","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/UKHO%2Fexchange-set-service/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/UKHO%2Fexchange-set-service/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/UKHO%2Fexchange-set-service/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/UKHO","download_url":"https://codeload.github.com/UKHO/exchange-set-service/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/UKHO%2Fexchange-set-service/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":273539317,"owners_count":25123499,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-04T02:00:08.968Z","response_time":61,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-09-04T02:07:26.650Z","updated_at":"2025-09-04T02:07:27.514Z","avatar_url":"https://github.com/UKHO.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# exchange-set-service\n\nThe Exchange Set Service will allow distributors to request custom exchange sets, built to the [S-63 specification](https://en.wikipedia.org/wiki/S-63_(encryption_standard)) for delivery of ENC data to vessels.\n\nAn exchange set is defined in the [IC-ENC Glossary](http://www.ic-enc.org/Glossary.html) as:\n\n\u003e An exchange set is a grouping of data sets in a logical, consistent and self-contained collection to support the interchange of geospatial data and meta data.\n\nRead more in the full [IHO S-63 Specification](https://iho.int/uploads/user/Services%20and%20Standards/ENC_ECDIS/data_protection/S-63_e1.2.0_EN_Jan2015.pdf).\n\nAn exchange set can be loaded into an ECDIS (Electronic Chart Display and Information System) on a vessel for navigation planning.\n\n## Viewing the API Spec\n\nRather than reading the OpenAPI specification in raw form, copy the API specification YAML file into [an online Swagger editor](https://editor.swagger.io/) for a rendered view.\n\n## Calling the Exchange Set Service\n\n*Note that this section is draft, based on what we are doing for the [File Share Service (FSS)](https://github.com/UKHO/file-share-service/)*\n\n### Using ESS in Postman\n\nTo generate an authorization token in Postman follow these steps:\n\n#### Get Authorization for the environment's App Registration\n\nAsk Calypso (or service Owner) to give you Roles for the ESS App Registration:\n\n* `ESS-API-DEV`\n* `ESS-API-QA`\n* `ESS-API-LIVE`\n\n#### Select OAuth2.0\n\nSelect `Oauth 2.0` in the authorization tab.\n\n![OAuth2 Postman Section](/Documentation/Images/PostmanAuthTabOauth.PNG)\n\n#### Fill in the OAuth section, click get new access token, login from the popup window\n\nGrant Type - Implicit\n\nAuth URL - `https://login.microsoftonline.com/9134ca48-663d-4a05-968a-31a42f0aed3e/oauth2/v2.0/authorize`\n\nClient ID:\n\n| Environment | Client ID |\n| -- | -- |\n| DEV | 80a6c68b-59aa-49a4-939a-7968ff79d676 |\n| QA | 644e4406-4e92-4e5d-bdc5-3b233884f900 |\n| LIVE | fd4cb7ab-ed8f-4398-bafa-4f83284febbe |\n* QA ### TBC ###\n* LIVE ### TBC ###\n\nScope:\n\n| Environment | Scope |\n| -- | -- |\n| DEV | 80a6c68b-59aa-49a4-939a-7968ff79d676/.default |\n| QA | 644e4406-4e92-4e5d-bdc5-3b233884f900/.default |\n| LIVE | fd4cb7ab-ed8f-4398-bafa-4f83284febbe/.default |\n* QA ### TBC ###/.default\n* LIVE ### TBC ###/.default\n\nNOTE: The browser used to authenticate needs to allow popups!\n\n![OAuth2 Postman Section](/Documentation/Images/PostmanAuthTabOauthDetails.PNG)\n\n#### Update the token\n\nPaste the token into the `Access Token` field at the top of the Postman OAuth2 section.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fukho%2Fexchange-set-service","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fukho%2Fexchange-set-service","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fukho%2Fexchange-set-service/lists"}