From 15b82bb552728ae9d07a9a459256112390cc3ab2 Mon Sep 17 00:00:00 2001 From: Eric Murray Date: Thu, 28 Aug 2025 11:36:09 +0100 Subject: [PATCH 01/23] Update device-roaming-status-subscriptions.yaml --- code/API_definitions/device-roaming-status-subscriptions.yaml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/code/API_definitions/device-roaming-status-subscriptions.yaml b/code/API_definitions/device-roaming-status-subscriptions.yaml index 1d1d047..ec37dcb 100644 --- a/code/API_definitions/device-roaming-status-subscriptions.yaml +++ b/code/API_definitions/device-roaming-status-subscriptions.yaml @@ -144,14 +144,14 @@ info: license: name: Apache 2.0 url: https://www.apache.org/licenses/LICENSE-2.0.html - version: wip + version: 0.8.0 x-camara-commonalities: 0.6 externalDocs: description: Product documentation at CAMARA url: https://github.com/camaraproject/DeviceStatus servers: - - url: "{apiRoot}/device-roaming-status-subscriptions/vwip" + - url: "{apiRoot}/device-roaming-status-subscriptions/v0.8" variables: apiRoot: default: http://localhost:9091 From 3ffb3a4eff4e648f6e9d5791ff9944fabfa7197b Mon Sep 17 00:00:00 2001 From: Eric Murray Date: Thu, 28 Aug 2025 11:37:01 +0100 Subject: [PATCH 02/23] Update device-roaming-status.yaml --- code/API_definitions/device-roaming-status.yaml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/code/API_definitions/device-roaming-status.yaml b/code/API_definitions/device-roaming-status.yaml index fbbc12a..c67a669 100644 --- a/code/API_definitions/device-roaming-status.yaml +++ b/code/API_definitions/device-roaming-status.yaml @@ -86,14 +86,14 @@ info: license: name: Apache 2.0 url: https://www.apache.org/licenses/LICENSE-2.0.html - version: wip + version: 1.1.0 x-camara-commonalities: 0.6 externalDocs: description: Product documentation at CAMARA url: https://github.com/camaraproject/DeviceStatus servers: - - url: "{apiRoot}/device-roaming-status/vwip" + - url: "{apiRoot}/device-roaming-status/v1" variables: apiRoot: default: http://localhost:9091 From fde2a57395b2ac55a8a591666045418f7ccd48ec Mon Sep 17 00:00:00 2001 From: Eric Murray Date: Thu, 28 Aug 2025 11:42:22 +0100 Subject: [PATCH 03/23] Update device-roaming-status-subscriptions-deleteDeviceRoamingStatusSubscription.feature --- ...ubscriptions-deleteDeviceRoamingStatusSubscription.feature | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/code/Test_definitions/device-roaming-status-subscriptions-deleteDeviceRoamingStatusSubscription.feature b/code/Test_definitions/device-roaming-status-subscriptions-deleteDeviceRoamingStatusSubscription.feature index a72431f..9511d51 100644 --- a/code/Test_definitions/device-roaming-status-subscriptions-deleteDeviceRoamingStatusSubscription.feature +++ b/code/Test_definitions/device-roaming-status-subscriptions-deleteDeviceRoamingStatusSubscription.feature @@ -1,5 +1,5 @@ # device-status-roaming-subscriptions-deleteDeviceRoamingStatusSubscription -Feature: Device Roaming Status Subscriptions API, vwip - Operation deleteDeviceRoamingStatusSubscription +Feature: Device Roaming Status Subscriptions API, v0.8.0 - Operation deleteDeviceRoamingStatusSubscription # Input to be provided by the implementation to the tester # @@ -14,7 +14,7 @@ Feature: Device Roaming Status Subscriptions API, vwip - Operation deleteDeviceR # References to OAS spec schemas refer to schemas specified in device-roaming-status-subscriptions.yaml Background: Common Device Roaming Status Subscriptions setup - Given the resource "{apiroot}/device-roaming-status-subscriptions/vwip" as base-url + Given the resource "{apiroot}/device-roaming-status-subscriptions/v0.8" as base-url And the header "Authorization" is set to a valid access token And the header "x-correlator" complies with the schema at "#/components/schemas/XCorrelator" From 780d112088d534877132916f118b9e767dcd20ac Mon Sep 17 00:00:00 2001 From: Eric Murray Date: Thu, 28 Aug 2025 11:43:13 +0100 Subject: [PATCH 04/23] Update device-roaming-status-subscriptions-deleteDeviceRoamingStatusSubscription.feature --- ...-subscriptions-deleteDeviceRoamingStatusSubscription.feature | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/code/Test_definitions/device-roaming-status-subscriptions-deleteDeviceRoamingStatusSubscription.feature b/code/Test_definitions/device-roaming-status-subscriptions-deleteDeviceRoamingStatusSubscription.feature index 9511d51..4359dda 100644 --- a/code/Test_definitions/device-roaming-status-subscriptions-deleteDeviceRoamingStatusSubscription.feature +++ b/code/Test_definitions/device-roaming-status-subscriptions-deleteDeviceRoamingStatusSubscription.feature @@ -14,7 +14,7 @@ Feature: Device Roaming Status Subscriptions API, v0.8.0 - Operation deleteDevic # References to OAS spec schemas refer to schemas specified in device-roaming-status-subscriptions.yaml Background: Common Device Roaming Status Subscriptions setup - Given the resource "{apiroot}/device-roaming-status-subscriptions/v0.8" as base-url + Given the resource "{apiroot}/device-roaming-status-subscriptions/v0.8/subscriptions" as base-url And the header "Authorization" is set to a valid access token And the header "x-correlator" complies with the schema at "#/components/schemas/XCorrelator" From 6257d9c3b762065adbeb0a7637fa0d31ab4495ef Mon Sep 17 00:00:00 2001 From: Eric Murray Date: Thu, 28 Aug 2025 11:43:42 +0100 Subject: [PATCH 05/23] Update device-roaming-status.feature --- code/Test_definitions/device-roaming-status.feature | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/code/Test_definitions/device-roaming-status.feature b/code/Test_definitions/device-roaming-status.feature index e95ffdf..7c50e0b 100644 --- a/code/Test_definitions/device-roaming-status.feature +++ b/code/Test_definitions/device-roaming-status.feature @@ -1,5 +1,5 @@ # device-roaming-status -Feature: CAMARA Device Roaming Status API, vwip - Operation getRoamingStatus +Feature: CAMARA Device Roaming Status API, v1.1.0 - Operation getRoamingStatus # Input to be provided by the implementation to the tester # # Implementation indications: @@ -12,7 +12,7 @@ Feature: CAMARA Device Roaming Status API, vwip - Operation getRoamingStatus # References to OAS spec schemas refer to schemas specifies in device-roaming-status.yaml Background: Common getRoamingStatus setup - Given the resource "{api-root}/device-roaming-status/vwip/retrieve" set as base-url + Given the resource "{api-root}/device-roaming-status/v1/retrieve" set as base-url And the header "Content-Type" is set to "application/json" And the header "Authorization" is set to a valid access token And the header "x-correlator" complies with the schema at "#/components/schemas/XCorrelator" From 8220038d6849245091354966d73c1558253c8283 Mon Sep 17 00:00:00 2001 From: Eric Murray Date: Thu, 28 Aug 2025 11:44:17 +0100 Subject: [PATCH 06/23] Update device-status-roaming-subscriptions-createDeviceRoamingStatusSubscription.feature --- ...ubscriptions-createDeviceRoamingStatusSubscription.feature | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/code/Test_definitions/device-status-roaming-subscriptions-createDeviceRoamingStatusSubscription.feature b/code/Test_definitions/device-status-roaming-subscriptions-createDeviceRoamingStatusSubscription.feature index c462f25..73307dc 100644 --- a/code/Test_definitions/device-status-roaming-subscriptions-createDeviceRoamingStatusSubscription.feature +++ b/code/Test_definitions/device-status-roaming-subscriptions-createDeviceRoamingStatusSubscription.feature @@ -1,5 +1,5 @@ # device-status-roaming-subscriptions-createDeviceRoamingStatusSubscription -Feature: Device Roaming Status Subscriptions API, vwip - Operation createDeviceRoamingStatusSubscription +Feature: Device Roaming Status Subscriptions API, v0.8.0 - Operation createDeviceRoamingStatusSubscription # Input to be provided by the implementation to the tester # @@ -14,7 +14,7 @@ Feature: Device Roaming Status Subscriptions API, vwip - Operation createDeviceR # References to OAS spec schemas refer to schemas specified in device-roaming-status-subscriptions.yaml Background: Common Device Roaming Status Subscriptions setup - Given the resource "{apiroot}/device-roaming-status-subscriptions/vwip" as base-url + Given the resource "{apiroot}/device-roaming-status-subscriptions/v0.8/subscriptions" as base-url And the header "Authorization" is set to a valid access token And the header "x-correlator" complies with the schema at "#/components/schemas/XCorrelator" And the request body is compliant with the OAS schema at "#/component/schemas/SubscriptionRequest" From a2da66787f1910c371dadf09ceb8e9d0553cef7c Mon Sep 17 00:00:00 2001 From: Eric Murray Date: Thu, 28 Aug 2025 11:45:16 +0100 Subject: [PATCH 07/23] Update device-status-roaming-subscriptions-retrieveDeviceRoamingStatusSubscription.feature --- ...scriptions-retrieveDeviceRoamingStatusSubscription.feature | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/code/Test_definitions/device-status-roaming-subscriptions-retrieveDeviceRoamingStatusSubscription.feature b/code/Test_definitions/device-status-roaming-subscriptions-retrieveDeviceRoamingStatusSubscription.feature index 9922552..79491de 100644 --- a/code/Test_definitions/device-status-roaming-subscriptions-retrieveDeviceRoamingStatusSubscription.feature +++ b/code/Test_definitions/device-status-roaming-subscriptions-retrieveDeviceRoamingStatusSubscription.feature @@ -1,5 +1,5 @@ # device-status-roaming-subscriptions-retrieveDeviceRoamingStatusSubscription -Feature: Device Roaming Status Subscriptions API, vwip - Operation retrieveDeviceRoamingStatusSubscription +Feature: Device Roaming Status Subscriptions API, v0.8.0 - Operation retrieveDeviceRoamingStatusSubscription # Input to be provided by the implementation to the tester # @@ -14,7 +14,7 @@ Feature: Device Roaming Status Subscriptions API, vwip - Operation retrieveDevic # References to OAS spec schemas refer to schemas specified in device-roaming-status-subscriptions.yaml Background: Common Device Roaming Status Subscriptions setup - Given the resource "{apiroot}/device-roaming-status-subscriptions/vwip" as base-url + Given the resource "{apiroot}/device-roaming-status-subscriptions/v0.8/subscriptions" as base-url And the header "Authorization" is set to a valid access token And the header "x-correlator" complies with the schema at "#/components/schemas/XCorrelator" From 5dbea1f05fe34178f469f5af78075ffb80b88e44 Mon Sep 17 00:00:00 2001 From: Eric Murray Date: Thu, 28 Aug 2025 11:45:46 +0100 Subject: [PATCH 08/23] Update device-status-roaming-subscriptions-retrieveDeviceRoamingStatusSubscriptionList.feature --- ...ptions-retrieveDeviceRoamingStatusSubscriptionList.feature | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/code/Test_definitions/device-status-roaming-subscriptions-retrieveDeviceRoamingStatusSubscriptionList.feature b/code/Test_definitions/device-status-roaming-subscriptions-retrieveDeviceRoamingStatusSubscriptionList.feature index 4c3ad27..fd708a8 100644 --- a/code/Test_definitions/device-status-roaming-subscriptions-retrieveDeviceRoamingStatusSubscriptionList.feature +++ b/code/Test_definitions/device-status-roaming-subscriptions-retrieveDeviceRoamingStatusSubscriptionList.feature @@ -1,5 +1,5 @@ # device-status-roaming-subscriptions-retrieveDeviceRoamingStatusSubscriptionList -Feature: Device Roaming Status Subscriptions API, vwip - Operation retrieveDeviceRoamingStatusSubscriptionList +Feature: Device Roaming Status Subscriptions API, v0.8.0 - Operation retrieveDeviceRoamingStatusSubscriptionList # Input to be provided by the implementation to the tester # @@ -14,7 +14,7 @@ Feature: Device Roaming Status Subscriptions API, vwip - Operation retrieveDevic # References to OAS spec schemas refer to schemas specified in device-roaming-status-subscriptions.yaml Background: Common Device Roaming Status Subscriptions setup - Given the resource "{apiroot}/device-roaming-status-subscriptions/vwip" as base-url + Given the resource "{apiroot}/device-roaming-status-subscriptions/v0.8/subscriptions" as base-url And the header "Authorization" is set to a valid access token And the header "x-correlator" complies with the schema at "#/components/schemas/XCorrelator" From 4ebbefbbd9adaf22b754f19cc50045aea71f82b6 Mon Sep 17 00:00:00 2001 From: Eric Murray Date: Thu, 28 Aug 2025 11:48:39 +0100 Subject: [PATCH 09/23] Update device-roaming-status-API-Readiness-Checklist.md --- ...-roaming-status-API-Readiness-Checklist.md | 28 +++++++++---------- 1 file changed, 14 insertions(+), 14 deletions(-) diff --git a/documentation/API_documentation/device-roaming-status-API-Readiness-Checklist.md b/documentation/API_documentation/device-roaming-status-API-Readiness-Checklist.md index a5afe51..c438b23 100644 --- a/documentation/API_documentation/device-roaming-status-API-Readiness-Checklist.md +++ b/documentation/API_documentation/device-roaming-status-API-Readiness-Checklist.md @@ -1,22 +1,22 @@ # API Readiness Checklist -Checklist for device-roaming-status 1.1.0-rc.2 in r1.1. +Checklist for device-roaming-status 1.1.0 in r1.2. | Nr | API release assets | alpha | release-candidate | initial
public | stable
public | Status | Reference information | |----|----------------------------------------------|:-----:|:-----------------:|:-------:|:------:|:----:|:----:| -| 1 | API definition | M | M | M | M | Y | [/code/API_definitions/device-roaming-status.yaml](/code/API_definitions/device-roaming-status.yaml) | -| 2 | Design guidelines from Commonalities applied | O | M | M | M | Y | [r3.2](https://github.com/camaraproject/Commonalities/releases/tag/r3.2) | -| 3 | Guidelines from ICM applied | O | M | M | M | Y | [r3.2](https://github.com/camaraproject/IdentityAndConsentManagement/releases/tag/r3.2) | -| 4 | API versioning convention applied | M | M | M | M | Y | | -| 5 | API documentation | M | M | M | M | Y | inline in YAML | -| 6 | User stories | O | O | O | M | Y | [/documentation/API_documentation/device-roaming-status-User-Story.md](/documentation/API_documentation/device-roaming-status-User-Story.md) | -| 7 | Basic API test cases & documentation | O | M | M | M | Y | [/code/Test_definitions/device-roaming-status.feature](/code/Test_definitions/device-roaming-status.feature) | -| 8 | Enhanced API test cases & documentation | O | O | O | M | Y | [/code/Test_definitions/device-roaming-status.feature](/code/Test_definitions/device-roaming-status.feature) | -| 9 | Test result statement | O | O | O | M | Y | na | -| 10 | API release numbering convention applied | M | M | M | M | Y | | -| 11 | Change log updated | M | M | M | M | Y | [/CHANGELOG.md](/CHANGELOG.md) | -| 12 | Previous public release was certified | O | O | O | M | Y | see (1) | -| 13 | API description (for marketing) | O | O | M | M | | [wiki link](https://lf-camaraproject.atlassian.net/wiki/x/vYBmBQ) | +| 1 | API definition | M | M | M | M | Y | [/code/API_definitions/device-roaming-status.yaml](/code/API_definitions/device-roaming-status.yaml) | +| 2 | Design guidelines from Commonalities applied | O | M | M | M | Y | [r3.3](https://github.com/camaraproject/Commonalities/releases/tag/r3.3) | +| 3 | Guidelines from ICM applied | O | M | M | M | Y | [r3.3](https://github.com/camaraproject/IdentityAndConsentManagement/releases/tag/r3.3) | +| 4 | API versioning convention applied | M | M | M | M | Y | | +| 5 | API documentation | M | M | M | M | Y | inline in YAML | +| 6 | User stories | O | O | O | M | Y | [/documentation/API_documentation/device-roaming-status-User-Story.md](/documentation/API_documentation/device-roaming-status-User-Story.md) | +| 7 | Basic API test cases & documentation | O | M | M | M | Y | [/code/Test_definitions/device-roaming-status.feature](/code/Test_definitions/device-roaming-status.feature) | +| 8 | Enhanced API test cases & documentation | O | O | O | M | Y | [/code/Test_definitions/device-roaming-status.feature](/code/Test_definitions/device-roaming-status.feature) | +| 9 | Test result statement | O | O | O | M | Y | na | +| 10 | API release numbering convention applied | M | M | M | M | Y | | +| 11 | Change log updated | M | M | M | M | Y | [/CHANGELOG.md](/CHANGELOG.md) | +| 12 | Previous public release was certified | O | O | O | M | Y | see (1) | +| 13 | API description (for marketing) | O | O | M | M | Y | [wiki link](https://lf-camaraproject.atlassian.net/wiki/x/vYBmBQ) | (1) GSMA certified implementations of previous version by multiple operators (source: https://open-gateway.gsma.com/map as of 2025-03-11) From a4b64d628efead3c35c7fc0f2537bb7c1f679dad Mon Sep 17 00:00:00 2001 From: Eric Murray Date: Thu, 28 Aug 2025 11:50:20 +0100 Subject: [PATCH 10/23] Update device-roaming-status-subscriptions-API-Readiness-Checklist.md --- ...s-subscriptions-API-Readiness-Checklist.md | 26 +++++++++---------- 1 file changed, 13 insertions(+), 13 deletions(-) diff --git a/documentation/API_documentation/device-roaming-status-subscriptions-API-Readiness-Checklist.md b/documentation/API_documentation/device-roaming-status-subscriptions-API-Readiness-Checklist.md index 1896c89..50930f4 100644 --- a/documentation/API_documentation/device-roaming-status-subscriptions-API-Readiness-Checklist.md +++ b/documentation/API_documentation/device-roaming-status-subscriptions-API-Readiness-Checklist.md @@ -1,21 +1,21 @@ # API Readiness Checklist -Checklist for device-roaming-status-subscriptions 0.8.0-rc.1 in r1.1. +Checklist for device-roaming-status-subscriptions 0.8.0 in r1.2 | Nr | API release assets | alpha | release-candidate | initial
public | stable
public | Status | Reference information | |----|----------------------------------------------|:-----:|:-----------------:|:-------:|:------:|:----:|:----:| -| 1 | API definition | M | M | M | M | Y | [/code/API_definitions/device-roaming-status-subscriptions.yaml](/code/API_definitions/device-roaming-status-subscriptions.yaml) | -| 2 | Design guidelines from Commonalities applied | O | M | M | M | Y | [r3.2](https://github.com/camaraproject/Commonalities/releases/tag/r3.2) | -| 3 | Guidelines from ICM applied | O | M | M | M | Y | [r3.2](https://github.com/camaraproject/IdentityAndConsentManagement/releases/tag/r3.2) | -| 4 | API versioning convention applied | M | M | M | M | Y | | -| 5 | API documentation | M | M | M | M | Y | inline in YAML | -| 6 | User stories | O | O | O | M | N | | -| 7 | Basic API test cases & documentation | O | M | M | M | Y | [/code/Test_definitions/device-roaming-status-subscriptions.feature](/code/Test_definitions/device-roaming-status-subscriptions.feature) | -| 8 | Enhanced API test cases & documentation | O | O | O | M | N | | -| 9 | Test result statement | O | O | O | M | N | | -| 10 | API release numbering convention applied | M | M | M | M | Y | | -| 11 | Change log updated | M | M | M | M | Y | [/CHANGELOG.md](/CHANGELOG.md) | -| 12 | Previous public release was certified | O | O | O | M | N | | +| 1 | API definition | M | M | M | M | Y | [/code/API_definitions/device-roaming-status-subscriptions.yaml](/code/API_definitions/device-roaming-status-subscriptions.yaml) | +| 2 | Design guidelines from Commonalities applied | O | M | M | M | Y | [r3.3](https://github.com/camaraproject/Commonalities/releases/tag/r3.3) | +| 3 | Guidelines from ICM applied | O | M | M | M | Y | [r3.3](https://github.com/camaraproject/IdentityAndConsentManagement/releases/tag/r3.3) | +| 4 | API versioning convention applied | M | M | M | M | Y | | +| 5 | API documentation | M | M | M | M | Y | inline in YAML | +| 6 | User stories | O | O | O | M | N | | +| 7 | Basic API test cases & documentation | O | M | M | M | Y | [/code/Test_definitions/device-roaming-status-subscriptions.feature](/code/Test_definitions/device-roaming-status-subscriptions.feature) | +| 8 | Enhanced API test cases & documentation | O | O | O | M | N | | +| 9 | Test result statement | O | O | O | M | N | | +| 10 | API release numbering convention applied | M | M | M | M | Y | | +| 11 | Change log updated | M | M | M | M | Y | [/CHANGELOG.md](/CHANGELOG.md) | +| 12 | Previous public release was certified | O | O | O | M | N | | | 13 | API description (for marketing) | O | O | M | M | | [wiki link](https://lf-camaraproject.atlassian.net/wiki/x/D4FlBQ) | Note: the checklists of a public API version and of its preceding release-candidate API version can be the same. From 115d7c9f1c839c209e7b10c664e7a0d3ef4ca742 Mon Sep 17 00:00:00 2001 From: Eric Murray Date: Thu, 28 Aug 2025 11:59:45 +0100 Subject: [PATCH 11/23] Update CHANGELOG.md --- CHANGELOG.md | 66 +++++++++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 65 insertions(+), 1 deletion(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index c8df44d..25df10f 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,6 @@ # Changelog DeviceRoamingStatus ## Table of Contents +- [r1.2](#r12) - [r1.1](#r11) **Please be aware that the project will have frequent updates to the main branch. There are no compatibility guarantees associated with code in any branch, including main, until it has been released. For example, changes may be reverted before a release is published. For the best results, use the latest published release.** @@ -12,6 +13,70 @@ The below sections record the changes for each API version in each release as fo - for a public release, the consolidated changes since the previous public release Note: this API had former releases in the [DeviceStatus](https://github.com/camaraproject/DeviceStatus) repository + +# r1.2 +## Release Notes + +This public release contains the definition and documentation of +* device-roaming-status v1.1.0 +* device-roaming-status-subscriptions v0.8.0 + +The API definition(s) are based on +* Commonalities v0.6.0 (r3.3) +* Identity and Consent Management v0.4.0 (r3.3) + +## device-roaming-status v1.1.0 +device-roaming-status v1.1.0 is a minor update of the API, and is backward compatible with v1.0.0. +- API definition **with inline documentation**: + - [View it on ReDoc](https://redocly.github.io/redoc/?url=https://raw.githubusercontent.com/camaraproject/DeviceRoamingStatus/r1.2/code/API_definitions/device-roaming-status.yaml&nocors) + - [View it on Swagger Editor](https://camaraproject.github.io/swagger-ui/?url=https://raw.githubusercontent.com/camaraproject/DeviceRoamingStatus/r1.2/code/API_definitions/device-roaming-status.yaml) + - OpenAPI [YAML spec file](https://github.com/camaraproject/DeviceRoamingStatus/blob/r1.2/code/API_definitions/device-roaming-status.yaml) + +### Added + +### Changed +* Make lastStatusTime mandatory in 200 responses of the API by @eric-murray in https://github.com/camaraproject/DeviceRoamingStatus/pull/19 +* Update error response documentation in OAS definitions by @eric-murray in https://github.com/camaraproject/DeviceRoamingStatus/pull/30 +* Update x-correlator schema by @eric-murray in https://github.com/camaraproject/DeviceRoamingStatus/pull/29 +* Commonalities alignement for device roaming status by @bigludo7 in https://github.com/camaraproject/DeviceRoamingStatus/pull/37 +* Update error schema for compliance with Commonalities r3.3 by @eric-murray in https://github.com/camaraproject/DeviceRoamingStatus/pull/45 +* admin: migrate to centralized linting workflows by @hdamker-bot in https://github.com/camaraproject/DeviceRoamingStatus/pull/41 + +### Fixed +* Fix feature files for compliance with centralised linting rules by @eric-murray in https://github.com/camaraproject/DeviceRoamingStatus/pull/42 + +### Removed +* Remove AUTHENTICATION_REQUIRED error code by @eric-murray in https://github.com/camaraproject/DeviceRoamingStatus/pull/14 +* Update OAS and test definitions to remove IDENTIFIER_MISMATCH error code by @eric-murray in https://github.com/camaraproject/DeviceRoamingStatus/pull/22 + +## device-roaming-status-subscriptions v0.8.0 +- API definition **with inline documentation**: + - [View it on ReDoc](https://redocly.github.io/redoc/?url=https://raw.githubusercontent.com/camaraproject/DeviceRoamingStatus/r1.2/code/API_definitions/device-roaming-status-subscriptions.yaml&nocors) + - [View it on Swagger Editor](https://camaraproject.github.io/swagger-ui/?url=https://raw.githubusercontent.com/camaraproject/DeviceRoamingStatus/r1.2/code/API_definitions/device-roaming-status-subscriptions.yaml) + - OpenAPI [YAML spec file](https://github.com/camaraproject/DeviceRoamingStatus/blob/r1.2/code/API_definitions/device-roaming-status-subscriptions.yaml) + +### Added +* Add subscription started & updated event by @bigludo7 in https://github.com/camaraproject/DeviceRoamingStatus/pull/35 + +### Changed +* change sink format to format: uri by @maxl2287 in https://github.com/camaraproject/DeviceRoamingStatus/pull/18 +* Rename subscription-ends event to subscription-ended by @eric-murray in https://github.com/camaraproject/DeviceRoamingStatus/pull/31 +* Update error response documentation in OAS definitions by @eric-murray in https://github.com/camaraproject/DeviceRoamingStatus/pull/30 +* Update x-correlator schema by @eric-murray in https://github.com/camaraproject/DeviceRoamingStatus/pull/29 +* Commonalities alignement for device roaming subscription by @bigludo7 in https://github.com/camaraproject/DeviceRoamingStatus/pull/37 +* Update error schema for compliance with Commonalities r3.3 by @eric-murray in https://github.com/camaraproject/DeviceRoamingStatus/pull/45 +* admin: migrate to centralized linting workflows by @hdamker-bot in https://github.com/camaraproject/DeviceRoamingStatus/pull/41 + +### Fixed +* remove "Generic High Entropy Secret" by @maxl2287 in https://github.com/camaraproject/DeviceRoamingStatus/pull/17 +* Fix feature files for compliance with centralised linting rules by @eric-murray in https://github.com/camaraproject/DeviceRoamingStatus/pull/42 + +### Removed +* Remove AUTHENTICATION_REQUIRED error code by @eric-murray in https://github.com/camaraproject/DeviceRoamingStatus/pull/14 +* Update OAS and test definitions to remove IDENTIFIER_MISMATCH error code by @eric-murray in https://github.com/camaraproject/DeviceRoamingStatus/pull/22 + +**Full Changelog**: https://github.com/camaraproject/DeviceRoamingStatus/commits/r1.2 + # r1.1 ## Release Notes @@ -73,4 +138,3 @@ device-roaming-status v1.1.0 will be a minor update of the API, and is backward * Update OAS and test definitions to remove IDENTIFIER_MISMATCH error code by @eric-murray in https://github.com/camaraproject/DeviceRoamingStatus/pull/22 **Full Changelog**: https://github.com/camaraproject/DeviceRoamingStatus/commits/r1.1 - From b0f48149b2a2462cfc3cc3c6778ced86b8f59552 Mon Sep 17 00:00:00 2001 From: Eric Murray Date: Thu, 28 Aug 2025 12:08:10 +0100 Subject: [PATCH 12/23] Update README.md --- README.md | 18 ++++++++++++------ 1 file changed, 12 insertions(+), 6 deletions(-) diff --git a/README.md b/README.md index 929ed75..6dc5c78 100644 --- a/README.md +++ b/README.md @@ -25,12 +25,18 @@ Incubating API Repository to evolve and maintain the definitions and documentati ## Release Information -The latest public release of the Device Status repository, including the DeviceRoamingStatus API, is available here: https://github.com/camaraproject/DeviceStatus/releases/latest - - -Pre-releases of this sub project are available in https://github.com/camaraproject/DeviceRoamingStatus/releases - - +The latest public release of the DeviceRoamingStatus repository is available [here](https://github.com/camaraproject/DeviceRoamingStatus/releases/latest) + + * **device-roaming-status v1.1.0** + [[YAML]](https://github.com/camaraproject/DeviceRoamingStatus/blob/r1.2/code/API_definitions/device-roaming-status.yaml) + [[View it on ReDoc]](https://redocly.github.io/redoc/?url=https://raw.githubusercontent.com/camaraproject/DeviceRoamingStatus/r1.2/code/API_definitions/device-roaming-status.yaml&nocors) + [[View it on Swagger Editor]](https://camaraproject.github.io/swagger-ui/?url=https://raw.githubusercontent.com/camaraproject/DeviceRoamingStatus/r1.2/code/API_definitions/device-roaming-status.yaml) + * **device-roaming-status-subscriptions v0.8.0** + [[YAML]](https://github.com/camaraproject/DeviceRoamingStatus/blob/r1.2/code/API_definitions/device-roaming-status-subscriptions.yaml) + [[View it on ReDoc]](https://redocly.github.io/redoc/?url=https://raw.githubusercontent.com/camaraproject/DeviceRoamingStatus/r1.2/code/API_definitions/device-roaming-status-subscriptions.yaml&nocors) + [[View it on Swagger Editor]](https://camaraproject.github.io/swagger-ui/?url=https://raw.githubusercontent.com/camaraproject/DeviceRoamingStatus/r1.2/code/API_definitions/device-roaming-status-subscriptions.yaml) + +Pre-releases of this sub project are available [here](https://github.com/camaraproject/DeviceRoamingStatus/releases). For changes see the [change log](https://github.com/camaraproject/DeviceRoamingStatus/blob/main/CHANGELOG.md). ## Contributing From cef774cb786f999a9339dce0bad7dfa52153f546 Mon Sep 17 00:00:00 2001 From: Eric Murray Date: Thu, 28 Aug 2025 12:26:27 +0100 Subject: [PATCH 13/23] Update device-roaming-status-subscriptions.yaml --- code/API_definitions/device-roaming-status-subscriptions.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/code/API_definitions/device-roaming-status-subscriptions.yaml b/code/API_definitions/device-roaming-status-subscriptions.yaml index ec37dcb..04cff8e 100644 --- a/code/API_definitions/device-roaming-status-subscriptions.yaml +++ b/code/API_definitions/device-roaming-status-subscriptions.yaml @@ -148,7 +148,7 @@ info: x-camara-commonalities: 0.6 externalDocs: description: Product documentation at CAMARA - url: https://github.com/camaraproject/DeviceStatus + url: https://github.com/camaraproject/DeviceRoamingStatus servers: - url: "{apiRoot}/device-roaming-status-subscriptions/v0.8" From 6120f8cf9f5620c8aed40775db4787cf9f45c09c Mon Sep 17 00:00:00 2001 From: Eric Murray Date: Thu, 28 Aug 2025 12:27:11 +0100 Subject: [PATCH 14/23] Update device-roaming-status.yaml --- code/API_definitions/device-roaming-status.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/code/API_definitions/device-roaming-status.yaml b/code/API_definitions/device-roaming-status.yaml index c67a669..34652aa 100644 --- a/code/API_definitions/device-roaming-status.yaml +++ b/code/API_definitions/device-roaming-status.yaml @@ -90,7 +90,7 @@ info: x-camara-commonalities: 0.6 externalDocs: description: Product documentation at CAMARA - url: https://github.com/camaraproject/DeviceStatus + url: https://github.com/camaraproject/DeviceRoamingStatus servers: - url: "{apiRoot}/device-roaming-status/v1" From 7397291508b088c25b05efdfc48c2afc01679442 Mon Sep 17 00:00:00 2001 From: Eric Murray Date: Thu, 28 Aug 2025 13:07:02 +0100 Subject: [PATCH 15/23] Update device-roaming-status-API-Readiness-Checklist.md --- ...ice-roaming-status-API-Readiness-Checklist.md | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/documentation/API_documentation/device-roaming-status-API-Readiness-Checklist.md b/documentation/API_documentation/device-roaming-status-API-Readiness-Checklist.md index c438b23..12b4e51 100644 --- a/documentation/API_documentation/device-roaming-status-API-Readiness-Checklist.md +++ b/documentation/API_documentation/device-roaming-status-API-Readiness-Checklist.md @@ -4,18 +4,18 @@ Checklist for device-roaming-status 1.1.0 in r1.2. | Nr | API release assets | alpha | release-candidate | initial
public | stable
public | Status | Reference information | |----|----------------------------------------------|:-----:|:-----------------:|:-------:|:------:|:----:|:----:| -| 1 | API definition | M | M | M | M | Y | [/code/API_definitions/device-roaming-status.yaml](/code/API_definitions/device-roaming-status.yaml) | -| 2 | Design guidelines from Commonalities applied | O | M | M | M | Y | [r3.3](https://github.com/camaraproject/Commonalities/releases/tag/r3.3) | +| 1 | API definition | M | M | M | M | Y | [device-roaming-status.yaml](/code/API_definitions/device-roaming-status.yaml) | +| 2 | Design guidelines from Commonalities applied | O | M | M | M | Y | [r3.3](https://github.com/camaraproject/Commonalities/releases/tag/r3.3) | | 3 | Guidelines from ICM applied | O | M | M | M | Y | [r3.3](https://github.com/camaraproject/IdentityAndConsentManagement/releases/tag/r3.3) | | 4 | API versioning convention applied | M | M | M | M | Y | | | 5 | API documentation | M | M | M | M | Y | inline in YAML | -| 6 | User stories | O | O | O | M | Y | [/documentation/API_documentation/device-roaming-status-User-Story.md](/documentation/API_documentation/device-roaming-status-User-Story.md) | -| 7 | Basic API test cases & documentation | O | M | M | M | Y | [/code/Test_definitions/device-roaming-status.feature](/code/Test_definitions/device-roaming-status.feature) | -| 8 | Enhanced API test cases & documentation | O | O | O | M | Y | [/code/Test_definitions/device-roaming-status.feature](/code/Test_definitions/device-roaming-status.feature) | -| 9 | Test result statement | O | O | O | M | Y | na | -| 10 | API release numbering convention applied | M | M | M | M | Y | | +| 6 | User stories | O | O | O | M | Y | [device-roaming-status-User-Story.md](/documentation/API_documentation/device-roaming-status-User-Story.md) | +| 7 | Basic API test cases & documentation | O | M | M | M | Y | [device-roaming-status.feature](/code/Test_definitions/device-roaming-status.feature) | +| 8 | Enhanced API test cases & documentation | O | O | O | M | Y | [device-roaming-status.feature](/code/Test_definitions/device-roaming-status.feature) | +| 9 | Test result statement | O | O | O | M | Y | See [here](https://github.com/camaraproject/DeviceRoamingStatus/issues/46) | +| 10 | API release numbering convention applied | M | M | M | M | Y | | | 11 | Change log updated | M | M | M | M | Y | [/CHANGELOG.md](/CHANGELOG.md) | -| 12 | Previous public release was certified | O | O | O | M | Y | see (1) | +| 12 | Previous public release was certified | O | O | O | M | Y | See (1) | | 13 | API description (for marketing) | O | O | M | M | Y | [wiki link](https://lf-camaraproject.atlassian.net/wiki/x/vYBmBQ) | (1) GSMA certified implementations of previous version by multiple operators (source: https://open-gateway.gsma.com/map as of 2025-03-11) From 2fe67af168877bf2a70e0d174bcbe58f86a98f67 Mon Sep 17 00:00:00 2001 From: Eric Murray Date: Thu, 28 Aug 2025 13:08:12 +0100 Subject: [PATCH 16/23] Update device-roaming-status-subscriptions-API-Readiness-Checklist.md --- ...oaming-status-subscriptions-API-Readiness-Checklist.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/documentation/API_documentation/device-roaming-status-subscriptions-API-Readiness-Checklist.md b/documentation/API_documentation/device-roaming-status-subscriptions-API-Readiness-Checklist.md index 50930f4..c1eba01 100644 --- a/documentation/API_documentation/device-roaming-status-subscriptions-API-Readiness-Checklist.md +++ b/documentation/API_documentation/device-roaming-status-subscriptions-API-Readiness-Checklist.md @@ -4,19 +4,19 @@ Checklist for device-roaming-status-subscriptions 0.8.0 in r1.2 | Nr | API release assets | alpha | release-candidate | initial
public | stable
public | Status | Reference information | |----|----------------------------------------------|:-----:|:-----------------:|:-------:|:------:|:----:|:----:| -| 1 | API definition | M | M | M | M | Y | [/code/API_definitions/device-roaming-status-subscriptions.yaml](/code/API_definitions/device-roaming-status-subscriptions.yaml) | +| 1 | API definition | M | M | M | M | Y | [device-roaming-status-subscriptions.yaml](/code/API_definitions/device-roaming-status-subscriptions.yaml) | | 2 | Design guidelines from Commonalities applied | O | M | M | M | Y | [r3.3](https://github.com/camaraproject/Commonalities/releases/tag/r3.3) | | 3 | Guidelines from ICM applied | O | M | M | M | Y | [r3.3](https://github.com/camaraproject/IdentityAndConsentManagement/releases/tag/r3.3) | | 4 | API versioning convention applied | M | M | M | M | Y | | | 5 | API documentation | M | M | M | M | Y | inline in YAML | | 6 | User stories | O | O | O | M | N | | -| 7 | Basic API test cases & documentation | O | M | M | M | Y | [/code/Test_definitions/device-roaming-status-subscriptions.feature](/code/Test_definitions/device-roaming-status-subscriptions.feature) | +| 7 | Basic API test cases & documentation | O | M | M | M | Y | [device-roaming-status-subscriptions.feature](/code/Test_definitions/device-roaming-status-subscriptions.feature) | | 8 | Enhanced API test cases & documentation | O | O | O | M | N | | | 9 | Test result statement | O | O | O | M | N | | | 10 | API release numbering convention applied | M | M | M | M | Y | | -| 11 | Change log updated | M | M | M | M | Y | [/CHANGELOG.md](/CHANGELOG.md) | +| 11 | Change log updated | M | M | M | M | Y | [CHANGELOG.md](/CHANGELOG.md) | | 12 | Previous public release was certified | O | O | O | M | N | | -| 13 | API description (for marketing) | O | O | M | M | | [wiki link](https://lf-camaraproject.atlassian.net/wiki/x/D4FlBQ) | +| 13 | API description (for marketing) | O | O | M | M | Y | [wiki link](https://lf-camaraproject.atlassian.net/wiki/x/D4FlBQ) | Note: the checklists of a public API version and of its preceding release-candidate API version can be the same. From 62a93f1eeba1acea484d4eff5299303c05f7bbc0 Mon Sep 17 00:00:00 2001 From: Eric Murray Date: Thu, 28 Aug 2025 13:08:29 +0100 Subject: [PATCH 17/23] Update device-roaming-status-API-Readiness-Checklist.md --- .../device-roaming-status-API-Readiness-Checklist.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documentation/API_documentation/device-roaming-status-API-Readiness-Checklist.md b/documentation/API_documentation/device-roaming-status-API-Readiness-Checklist.md index 12b4e51..4a75905 100644 --- a/documentation/API_documentation/device-roaming-status-API-Readiness-Checklist.md +++ b/documentation/API_documentation/device-roaming-status-API-Readiness-Checklist.md @@ -14,7 +14,7 @@ Checklist for device-roaming-status 1.1.0 in r1.2. | 8 | Enhanced API test cases & documentation | O | O | O | M | Y | [device-roaming-status.feature](/code/Test_definitions/device-roaming-status.feature) | | 9 | Test result statement | O | O | O | M | Y | See [here](https://github.com/camaraproject/DeviceRoamingStatus/issues/46) | | 10 | API release numbering convention applied | M | M | M | M | Y | | -| 11 | Change log updated | M | M | M | M | Y | [/CHANGELOG.md](/CHANGELOG.md) | +| 11 | Change log updated | M | M | M | M | Y | [CHANGELOG.md](/CHANGELOG.md) | | 12 | Previous public release was certified | O | O | O | M | Y | See (1) | | 13 | API description (for marketing) | O | O | M | M | Y | [wiki link](https://lf-camaraproject.atlassian.net/wiki/x/vYBmBQ) | From 39964c1c2493c0d7b4bbd6222bda9dc994cd85b0 Mon Sep 17 00:00:00 2001 From: Eric Murray Date: Thu, 28 Aug 2025 13:15:31 +0100 Subject: [PATCH 18/23] Rename device-status-roaming-subscriptions-createDeviceRoamingStatusSubscription.feature to device-roaming-status-subscriptions-createDeviceRoamingStatusSubscription.feature --- ...s-subscriptions-createDeviceRoamingStatusSubscription.feature} | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename code/Test_definitions/{device-status-roaming-subscriptions-createDeviceRoamingStatusSubscription.feature => device-roaming-status-subscriptions-createDeviceRoamingStatusSubscription.feature} (100%) diff --git a/code/Test_definitions/device-status-roaming-subscriptions-createDeviceRoamingStatusSubscription.feature b/code/Test_definitions/device-roaming-status-subscriptions-createDeviceRoamingStatusSubscription.feature similarity index 100% rename from code/Test_definitions/device-status-roaming-subscriptions-createDeviceRoamingStatusSubscription.feature rename to code/Test_definitions/device-roaming-status-subscriptions-createDeviceRoamingStatusSubscription.feature From ed3e585a45cb543a515d10952be96666f5721862 Mon Sep 17 00:00:00 2001 From: Eric Murray Date: Thu, 28 Aug 2025 13:15:50 +0100 Subject: [PATCH 19/23] Rename device-status-roaming-subscriptions-retrieveDeviceRoamingStatusSubscription.feature to device-roaming-status-subscriptions-retrieveDeviceRoamingStatusSubscription.feature --- ...subscriptions-retrieveDeviceRoamingStatusSubscription.feature} | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename code/Test_definitions/{device-status-roaming-subscriptions-retrieveDeviceRoamingStatusSubscription.feature => device-roaming-status-subscriptions-retrieveDeviceRoamingStatusSubscription.feature} (100%) diff --git a/code/Test_definitions/device-status-roaming-subscriptions-retrieveDeviceRoamingStatusSubscription.feature b/code/Test_definitions/device-roaming-status-subscriptions-retrieveDeviceRoamingStatusSubscription.feature similarity index 100% rename from code/Test_definitions/device-status-roaming-subscriptions-retrieveDeviceRoamingStatusSubscription.feature rename to code/Test_definitions/device-roaming-status-subscriptions-retrieveDeviceRoamingStatusSubscription.feature From 9b9ed363026342606f7b5ac8496b2c919c0600d4 Mon Sep 17 00:00:00 2001 From: Eric Murray Date: Thu, 28 Aug 2025 13:16:07 +0100 Subject: [PATCH 20/23] Rename device-status-roaming-subscriptions-retrieveDeviceRoamingStatusSubscriptionList.feature to device-roaming-status-subscriptions-retrieveDeviceRoamingStatusSubscriptionList.feature --- ...criptions-retrieveDeviceRoamingStatusSubscriptionList.feature} | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename code/Test_definitions/{device-status-roaming-subscriptions-retrieveDeviceRoamingStatusSubscriptionList.feature => device-roaming-status-subscriptions-retrieveDeviceRoamingStatusSubscriptionList.feature} (100%) diff --git a/code/Test_definitions/device-status-roaming-subscriptions-retrieveDeviceRoamingStatusSubscriptionList.feature b/code/Test_definitions/device-roaming-status-subscriptions-retrieveDeviceRoamingStatusSubscriptionList.feature similarity index 100% rename from code/Test_definitions/device-status-roaming-subscriptions-retrieveDeviceRoamingStatusSubscriptionList.feature rename to code/Test_definitions/device-roaming-status-subscriptions-retrieveDeviceRoamingStatusSubscriptionList.feature From fdb7ae4de3f35f16043f41abed68e239eb54a0b3 Mon Sep 17 00:00:00 2001 From: Ludovic Robert <30499179+bigludo7@users.noreply.github.com> Date: Wed, 10 Sep 2025 14:27:37 +0200 Subject: [PATCH 21/23] Fix link to commonalities line 869 --- code/API_definitions/device-roaming-status-subscriptions.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/code/API_definitions/device-roaming-status-subscriptions.yaml b/code/API_definitions/device-roaming-status-subscriptions.yaml index 309b5fd..8924ee0 100644 --- a/code/API_definitions/device-roaming-status-subscriptions.yaml +++ b/code/API_definitions/device-roaming-status-subscriptions.yaml @@ -866,7 +866,7 @@ components: SubscriptionId: type: string - description: The unique identifier of the subscription in the scope of the subscription manager. When this information is contained within an event notification, this concept SHALL be referred as `subscriptionId` as per [Commonalities Event Notification Model](https://github.com/camaraproject/Commonalities/blob/r2.3/documentation/API-design-guidelines.md#122-event-notification). + description: The unique identifier of the subscription in the scope of the subscription manager. When this information is contained within an event notification, this concept SHALL be referred as `subscriptionId` as per [Commonalities Event Notification Definition](https://github.com/camaraproject/Commonalities/blob/main/documentation/CAMARA-API-Event-Subscription-and-Notification-Guide.md#31-event-notification-definition). example: qs15-h556-rt89-1298 CloudEvent: From fb402ad92481c9050c555f057c31ea682ce69896 Mon Sep 17 00:00:00 2001 From: Ludovic Robert <30499179+bigludo7@users.noreply.github.com> Date: Wed, 10 Sep 2025 14:34:27 +0200 Subject: [PATCH 22/23] Fixed date-time attribute description --- .../device-roaming-status-subscriptions.yaml | 15 +++++---------- 1 file changed, 5 insertions(+), 10 deletions(-) diff --git a/code/API_definitions/device-roaming-status-subscriptions.yaml b/code/API_definitions/device-roaming-status-subscriptions.yaml index 8924ee0..92bb62b 100644 --- a/code/API_definitions/device-roaming-status-subscriptions.yaml +++ b/code/API_definitions/device-roaming-status-subscriptions.yaml @@ -498,18 +498,17 @@ components: type: string format: date-time example: 2023-01-17T13:18:23.682Z - description: The subscription expiration time (in date-time format) requested by the API consumer. Up to API project decision to keep it. + description: The subscription expiration time (in date-time format) requested by the API consumer. It must follow [RFC 3339](https://datatracker.ietf.org/doc/html/rfc3339#section-5.6) and must have time zone. subscriptionMaxEvents: type: integer - description: Identifies the maximum number of event reports to be generated (>=1) requested by the API consumer - Once this number is reached, the subscription ends. Up to API project decision to keep it. + description: Identifies the maximum number of event reports to be generated (>=1) requested by the API consumer - Once this number is reached, the subscription ends. minimum: 1 example: 5 initialEvent: type: boolean description: | - Set to `true` by API consumer if consumer wants to get an event as soon as the subscription is created and current situation reflects event request.Up to API project decision to keep it. - Example: Consumer request Roaming event. If consumer sets initialEvent to true and device is in roaming situation, an event is triggered - Up to API project decision to keep it. + Set to `true` by API consumer if consumer wants to get an event as soon as the subscription is created and current situation reflects event request. + Example: Consumer request Roaming event. If consumer sets initialEvent to true and device is in roaming situation, an event is triggered. SinkCredential: description: A sink credential provides authentication or authorization information necessary to enable delivery of events to a target. @@ -568,7 +567,6 @@ components: In the case of an ACCESS_TOKEN_EXPIRED termination reason, implementation should notify the client before the expiration date. If the access token is a JWT and registered "exp" (Expiration Time) claim is present, the two expiry times should match. It must follow [RFC 3339](https://datatracker.ietf.org/doc/html/rfc3339#section-5.6) and must have time zone. - Recommended format is yyyy-MM-dd'T'HH:mm:ss.SSSZ (i.e. which allows 2023-07-03T14:27:08.312+02:00 or 2023-07-03T12:27:08.312Z) example: "2023-07-03T12:27:08.312Z" accessTokenType: description: REQUIRED. Type of the access token (See [OAuth 2.0](https://tools.ietf.org/html/rfc6749#section-7.1)). @@ -598,7 +596,6 @@ components: In the case of an ACCESS_TOKEN_EXPIRED termination reason, implementation should notify the client before the expiration date. If the access token is a JWT and registered "exp" (Expiration Time) claim is present, the two expiry times should match. It must follow [RFC 3339](https://datatracker.ietf.org/doc/html/rfc3339#section-5.6) and must have time zone. - Recommended format is yyyy-MM-dd'T'HH:mm:ss.SSSZ (i.e. which allows 2023-07-03T14:27:08.312+02:00 or 2023-07-03T12:27:08.312Z) example: "2023-07-03T12:27:08.312Z" accessTokenType: description: REQUIRED. Type of the access token (See [OAuth 2.0](https://tools.ietf.org/html/rfc6749#section-7.1)). @@ -706,7 +703,6 @@ components: description: | Date when the event subscription will begin/began It must follow [RFC 3339](https://datatracker.ietf.org/doc/html/rfc3339#section-5.6) and must have time zone. - Recommended format is yyyy-MM-dd'T'HH:mm:ss.SSSZ (i.e. which allows 2023-07-03T14:27:08.312+02:00 or 2023-07-03T12:27:08.312Z) example: "2023-07-03T12:27:08.312Z" expiresAt: type: string @@ -714,7 +710,6 @@ components: description: | Date when the event subscription will expire. Only provided when `subscriptionExpireTime` is indicated by API client or Telco Operator has specific policy about that. It must follow [RFC 3339](https://datatracker.ietf.org/doc/html/rfc3339#section-5.6) and must have time zone. - Recommended format is yyyy-MM-dd'T'HH:mm:ss.SSSZ (i.e. which allows 2023-07-03T14:27:08.312+02:00 or 2023-07-03T12:27:08.312Z) example: "2023-07-03T12:27:08.312Z" status: type: string @@ -930,7 +925,7 @@ components: DateTime: type: string format: date-time - description: Timestamp of when the occurrence happened. Must adhere to RFC 3339. + description: Timestamp of when the occurrence happened. It must follow [RFC 3339](https://datatracker.ietf.org/doc/html/rfc3339#section-5.6) and must have time zone. example: "2018-04-05T17:31:00Z" EventRoamingStatus: From 80e3b4eff87803d01fcf7d606f4341fac8299da7 Mon Sep 17 00:00:00 2001 From: Ludovic Robert <30499179+bigludo7@users.noreply.github.com> Date: Mon, 15 Sep 2025 17:54:22 +0200 Subject: [PATCH 23/23] Update device-roaming-status-subscriptions.yaml --- code/API_definitions/device-roaming-status-subscriptions.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/code/API_definitions/device-roaming-status-subscriptions.yaml b/code/API_definitions/device-roaming-status-subscriptions.yaml index 92bb62b..68a0b41 100644 --- a/code/API_definitions/device-roaming-status-subscriptions.yaml +++ b/code/API_definitions/device-roaming-status-subscriptions.yaml @@ -861,7 +861,7 @@ components: SubscriptionId: type: string - description: The unique identifier of the subscription in the scope of the subscription manager. When this information is contained within an event notification, this concept SHALL be referred as `subscriptionId` as per [Commonalities Event Notification Definition](https://github.com/camaraproject/Commonalities/blob/main/documentation/CAMARA-API-Event-Subscription-and-Notification-Guide.md#31-event-notification-definition). + description: The unique identifier of the subscription in the scope of the subscription manager. When this information is contained within an event notification, this concept SHALL be referred as subscriptionId as per Commonalities Event Notification Model. example: qs15-h556-rt89-1298 CloudEvent: