r1.3

This patch release contains the definition and documentation of

• device-roaming-status v0.6.1
• device-roaming-status-subscriptions v0.6.1
• device-reachability-status v0.6.1
• device-reachability-status-subscriptions v0.6.1

The API definition(s) are based on

• Commonalities v0.4.0
• Identity and Consent Management v0.2.1

Note: these patch release notes are listing only the change compared to the r1.2 release. For the full list of changes of the 0.6.0 API versions compared to 0.5.x see r1.2.

device-roaming-status v0.6.1

• API definition with inline documentation:
  • View it on ReDoc
  • View it on Swagger Editor
  • OpenAPI YAML spec file

Added

Changed

Fixed

• Minor corrections in info.description by @akoshunyadi in #216

Removed

device-roaming-status-subscriptions v0.6.1

• API definition with inline documentation:
  • View it on ReDoc
  • View it on Swagger Editor
  • OpenAPI YAML spec file

Added

Changed

Fixed

• Add missing protocol-components for device-roaming-status-subscriptions by @maxl2287 in #208
• Correct the examples for sub - initialEvent and error MULTIEVENT_SUBSCRIPTION_NOT_SUPPORTED by @dfischer-tech in #210
• Minor corrections in info.description by @akoshunyadi in #216

Removed

device-reachability-status v0.6.1

• API definition with inline documentation:
  • View it on ReDoc
  • View it on Swagger Editor
  • OpenAPI YAML spec file

Added

Changed

• Update description of the reachability types by @akoshunyadi in #215

Fixed

• Minor corrections in info.description by @akoshunyadi in #216

Removed

device-reachability-status-subscriptions v0.6.1

• API definition with inline documentation:
  • View it on ReDoc
  • View it on Swagger Editor
  • OpenAPI YAML spec file

Added

Changed

• Update description of the reachability types by @akoshunyadi in #215

Fixed

• Correct the examples for sub - initialEvent and error MULTIEVENT_SUBSCRIPTION_NOT_SUPPORTED by @dfischer-tech in #210
• Minor corrections in info.description by @akoshunyadi in #216

Removed

Full Changelog: r1.2...r1.3

r1.2

This release contains the definition and documentation of

• device-roaming-status v0.6.0
• device-roaming-status-subscriptions v0.6.0
• device-reachability-status v0.6.0
• device-reachability-status-subscriptions v0.6.0

The API definition(s) are based on

• Commonalities v0.4.0
• Identity and Consent Management v0.2.0

Note: the previous device-status API with roaming and connectivity endpoints has been split into 4 specific APIs

device-roaming-status v0.6.0

• API definition with inline documentation:
  • View it on ReDoc
  • View it on Swagger Editor
  • OpenAPI YAML spec file

Added

• Addition of "lastStatusTime" Field by @sachinvodafone in #146
• include x-correlator by @fernandopradocabrillo in #112
• Create Gherkin tests for device-status-reachability and device-status-roaming by @mdomale in #186

Changed

• Change endpoint names to comply with guideline by @gmuratk in #131
• Make '+' mandatory for phoneNumber by @bigludo7 in #144
• Separate endpoint yamls proposal for direct API by @bigludo7 in #152
• Switch device structure to optional by @bigludo7 in #179
• device-reachability-status & device-roaming-status: Alignment of errors with Commonalities by @maxl2287 in #183
• Removing note that the API-scope is limited to 4G and 5G by @maxl2287 in #195

Fixed

• Renamed RequestRoamingStatus to RoamingStatusRequest by @maxl2287 in #194

Removed

• Remove terms of service and contact by @maxl2287 in #185
• Remove response code 405 by bigludo7 in #198

device-roaming-status-subscriptions v0.6.0

• API definition with inline documentation:
  • View it on ReDoc
  • View it on Swagger Editor
  • OpenAPI YAML spec file

Added

• Add termination reason SUBSCRIPTION_DELETED when subscription deleted by the user by @maxl2287 in #121
• include x-correlator by @fernandopradocabrillo in #112
• Create Gherkin tests for device-reachability-status-subscriptions & device-roaming-status-subscriptions by @mdomale in #187

Changed

• Make '+' mandatory for phoneNumber by @bigludo7 in #144
• split /subscription-endpoints into seperate APIs by @maxl2287 in #161
• renaming "EventType"-components to be more clear & update component descriptions by @maxl2287 in #141
• Update the subscription models to align on CAMARA commonalities by @maxl2287 in #170
• Removing note that the API-scope is limited to 4G and 5G by @maxl2287 in #195
• Subscription-APIs: Alignment of errors with Commonalities by @maxl2287 in #193

Fixed

Removed

• Remove terms of service and contact by @maxl2287 in #185

device-reachability-status v0.6.0

• API definition with inline documentation:
  • View it on ReDoc
  • View it on Swagger Editor
  • OpenAPI YAML spec file

Added

• Addition of "lastStatusTime" Field by @sachinvodafone in #146
• include x-correlator by @fernandopradocabrillo in #112
• Create Gherkin tests for device-status-reachability and device-status-roaming by @mdomale in #186

Changed

• Change endpoint names to comply with guideline by @gmuratk in #131
• Make '+' mandatory for phoneNumber by @bigludo7 in #144
• Separate endpoint yamls proposal for direct API by @bigludo7 in #152
• Switch device structure to optional by @bigludo7 in #179
• device-reachability-status & device-roaming-status: Alignment of errors with Commonalities by @maxl2287 in #183
• Removing note that the API-scope is limited to 4G and 5G by @maxl2287 in #195

Fixed

Removed

• Remove terms of service and contact by @maxl2287 in #185
• Remove response code 405 by bigludo7 in #198

device-reachability-status-subscriptions v0.6.0

• API definition with inline documentation:
  • View it on ReDoc
  • View it on Swagger Editor
  • OpenAPI YAML spec file

Added

• Add termination reason SUBSCRIPTION_DELETED when subscription deleted by the user by @maxl2287 in #121
• include x-correlator by @fernandopradocabrillo in #112
• Create Gherkin tests for device-reachability-status-subscriptions & device-roaming-status-subscriptions by @mdomale in #187

Changed

• renaming "EventType"-components to be more clear & update component descriptions by @maxl2287 in #141
• Make '+' mandatory for phoneNumber by @bigludo7 in #144
• split /subscription-endpoints into seperate APIs by @maxl2287 in #161
• Update the subscription models to align on CAMARA commonalities by @maxl2287 in #170
• Removing note that the API-scope is limited to 4G and 5G by @maxl2287 in #195
• Subscription-APIs: Alignment of errors with Commonalities by @maxl2287 in #193

Fixed

Removed

• Remove terms of service and contact by @maxl2287 in #185

Full Changelog: v0.5.1...r1.2

r1.1

Release Notes

This release contains the definition and documentation of

• device-roaming-status v0.6.0-rc.1
• device-roaming-status-subscriptions v0.6.0-rc.1
• device-reachability-status v0.6.0-rc.1
• device-reachability-status-subscriptions v0.6.0-rc.1

The API definition(s) are based on

• Commonalities v0.4.0-rc.1
• Identity and Consent Management v0.2.0-rc.1

Note: the previous device-status API with roaming and connectivity endpoints has been splitted into 4 specific APIs

device-roaming-status v0.6.0-rc.1

device-roaming-status v0.6.0-rc.1 is the 1st release candidate of the version 0.6

• API definition with inline documentation:
  • View it on ReDoc
  • View it on Swagger Editor
  • OpenAPI YAML spec file

Added

• Addition of "lastStatusTime" Field by @sachinvodafone in #146
• include x-correlator by @fernandopradocabrillo in #112

Changed

• Change endpoint names to comply with guideline by @gmuratk in #131
• Make '+' mandatory for phoneNumber by @bigludo7 in #144
• Separate endpoint yamls proposal for direct API by @bigludo7 in #152
• Switch device structure to optional by @bigludo7 in #179
• device-reachability-status & device-roaming-status: Alignment of errors with Commonalities by @maxl2287 in #183
• Removing note that the API-scope is limited to 4G and 5G by @maxl2287 in #195

Fixed

• Renamed RequestRoamingStatus to RoamingStatusRequest by @maxl2287 in #194

Removed

• Remove terms of service and contact by @maxl2287 in #185

device-roaming-status-subscriptions v0.6.0-rc.1

device-roaming-status-subscriptions v0.6.0-rc.1 is the 1st release candidate of the version 0.6

• API definition with inline documentation:
  • View it on ReDoc
  • View it on Swagger Editor
  • OpenAPI YAML spec file

Added

• Add termination reason SUBSCRIPTION_DELETED when subscription deleted by the user by @maxl2287 in #121
• include x-correlator by @fernandopradocabrillo in #112

Changed

• Make '+' mandatory for phoneNumber by @bigludo7 in #144
• split /subscription-endpoints into seperate APIs by @maxl2287 in #161
• renaming "EventType"-components to be more clear & update component descriptions by @maxl2287 in #141
• Update the subscription models to align on CAMARA commonalities by @maxl2287 in #170
• Removing note that the API-scope is limited to 4G and 5G by @maxl2287 in #195
• Subscription-APIs: Alignment of errors with Commonalities by @maxl2287 in #193

Fixed

Removed

• Remove terms of service and contact by @maxl2287 in #185

device-reachability-status v0.6.0-rc.1

device-reachability-status v0.6.0-rc.1 is the 1st release candidate of the version 0.6

• API definition with inline documentation:
  • View it on ReDoc
  • View it on Swagger Editor
  • OpenAPI YAML spec file

Added

• Addition of "lastStatusTime" Field by @sachinvodafone in #146
• include x-correlator by @fernandopradocabrillo in #112

Changed

• Change endpoint names to comply with guideline by @gmuratk in #131
• Make '+' mandatory for phoneNumber by @bigludo7 in #144
• Separate endpoint yamls proposal for direct API by @bigludo7 in #152
• Switch device structure to optional by @bigludo7 in #179
• device-reachability-status & device-roaming-status: Alignment of errors with Commonalities by @maxl2287 in #183
• Removing note that the API-scope is limited to 4G and 5G by @maxl2287 in #195

Fixed

Removed

• Remove terms of service and contact by @maxl2287 in #185

device-reachability-status-subscriptions v0.6.0-rc.1

device-reachability-status-subscriptions v0.6.0-rc.1 is the 1st release candidate of the version 0.6

• API definition with inline documentation:
  • View it on ReDoc
  • View it on Swagger Editor
  • OpenAPI YAML spec file

Added

• Add termination reason SUBSCRIPTION_DELETED when subscription deleted by the user by @maxl2287 in #121
• include x-correlator by @fernandopradocabrillo in #112

Changed

• renaming "EventType"-components to be more clear & update component descriptions by @maxl2287 in #141
• Make '+' mandatory for phoneNumber by @bigludo7 in #144
• split /subscription-endpoints into seperate APIs by @maxl2287 in #161
• Update the subscription models to align on CAMARA commonalities by @maxl2287 in #170
• Removing note that the API-scope is limited to 4G and 5G by @maxl2287 in #195
• Subscription-APIs: Alignment of errors with Commonalities by @maxl2287 in #193

Fixed

Removed

• Remove terms of service and contact by @maxl2287 in #185

Full Changelog: v0.5.1...r1.1

r0.6

Please note:

• This release contains an alpha version of the API, it should be considered as a draft.
• There are bug fixes to be expected and incompatible changes in upcoming versions.

Device Status - v0.6.0-alpha.1

• API definition with inline documentation:
  • OpenAPI YAML spec file
  • View it on ReDoc
  • View it on Swagger Editor

Main Changes

• Endpoints renamed
• New response parameter lastStatusTime

Added

• Addition of "lastStatusTime" Field by @sachinvodafone in #146
• include x-correlator by @fernandopradocabrillo in #112

Changed

• Change endpoint names to comply with guideline by @gmuratk in #131
• renaming "EventType"-components to be more clear & update component descriptions by @maxl2287 in #141
• Make '+' mandatory for phoneNumber by @bigludo7 in #144

Fixed

• NA

Removed

• NA

New Contributors

• NA

Full Changelog: v0.5.1...r0.6

v0.5.1

This is a bugfix release for the third alpha version of the CAMARA DeviceStatus API

• API definition with inline documentation:
  • OpenAPI YAML spec file
  • View it on ReDoc
  • View it on Swagger Editor

Please note:

• This is an alpha version, it should be considered as a draft.
• There are bug fixes to be expected and incompatible changes in upcoming versions.
• The release is suitable for implementors, but it is not recommended to use the API with customers in productive environments.

Main Changes

• Minor bugfixes
• Changes in the inline documentation

Added

• NA

Changed

• Change description that subscriptionExpireTime is optional by @maxl2287 in #120
• Updated in-line documentation for Roaming to clarify that country information can optionally be returned in the response. by @trehman-gsma in #127

Fixed

• fix: move "countryCode" out of "device" in ROAMING_CHANGE_COUNTRY-example by @maxl2287 in #106
• fix: add missing "subscriptionId" in "RoamingStatus"-data for CloudEvent by @maxl2287 in #109
• fix: change INVALID_INPUT for INVALID_ARGUMENT according to guidelines by @fernandopradocabrillo in #129

Removed

• NA

New Contributors

• @trehman-gsma made their first contribution in #127
• @fernandopradocabrillo made their first contribution in #129

Full Changelog: v0.5.0...v0.5.1

v0.5.0

This is the third alpha version of the CAMARA DeviceStatus API

• API definition with inline documentation:
  • OpenAPI YAML spec file
  • View it on ReDoc
  • View it on Swagger Editor

Please note:

• This release contains significant changes compared to v0.4.1, and it is not backward compatible
• This is an alpha version, it should be considered as a draft.
• There are bug fixes to be expected and incompatible changes in upcoming versions.
• The release is suitable for implementors, but it is not recommended to use the API with customers in productive environments.

Main Changes

• Added a new endpoint (/connectivity) to query the connectivity status of a device.
• Added the support for event notifications, based on CloudEvents, for both roaming and connectivity events.
• Reworked API security, now only Open-ID connect is allowed.

Added

• Added new endpoints to manage event-notifications for roaming events by @bigludo7 in #31
• Aligned event notification management with CloudEvents spec and added Open-Id connect as security method by @bigludo7 in #75
• Added a new endpoint and events to query the connectivity status of a device by @maxl2287 in #69

Changed

• Aligned error definition with guidelines by @monamok in #35

Fixed

• Aligned with common usage of allOf by @patrice-conil in #60
• Replaced subscriptionId with eventSubscriptionId by @patrice-conil in #64
• Corrections resolving linting errors by @rartych in #95

Removed

• NA

New Contributors

• @bigludo7 made their first contribution in #50
• @sachinvodafone made their first contribution in #51
• @patrice-conil made their first contribution in #59
• @SyeddR made their first contribution in #63
• @Sachinsiso made their first contribution in #68
• @rartych made their first contribution in #79
• @maxl2287 made their first contribution in #69

Full Changelog: v0.4.1...v0.5.0

v0.5.0-rc

This is the release candidate of v0.5.0 - containing the upcoming 3rd alpha version of the DeviceStatus API

• API definition with inline documentation:
  • OpenAPI YAML spec file
  • View it on ReDoc
  • View it on Swagger Editor

Please note:

• This release will contain significant changes compared to v0.4.1, and it is not backward compatible
• This is only the pre-release, it should be considered as a draft of the upcoming release v0.5.0
  • The pre-release is meant for implementors, but it is not recommended to use the API with customers in productive environments.

Main Changes

• Added a new endpoint (/connectivity) to query the connectivity status of a device.
• Added the support for event notifications, based on CloudEvents, for both roaming and connectivity events.
• Reworked API security, now only Open-ID connect is allowed.

Added

• Added new endpoints to manage event-notifications for roaming events by @bigludo7 in #31
• Aligned event notification management with CloudEvents spec and added Open-Id connect as security method by @bigludo7 in #75
• Added a new endpoint and events to query the connectivity status of a device by @maxl2287 in #69

Changed

• Aligned error definition with guidelines by @monamok in #35

Fixed

• Aligned with common usage of allOf by @patrice-conil in #60
• Replaced subscriptionId with eventSubscriptionId by @patrice-conil in #64

Removed

• NA

New Contributors

• @bigludo7 made their first contribution in #50
• @sachinvodafone made their first contribution in #51
• @patrice-conil made their first contribution in #59
• @SyeddR made their first contribution in #63
• @Sachinsiso made their first contribution in #68
• @rartych made their first contribution in #79
• @maxl2287 made their first contribution in #69

Full Changelog: v0.4.1...v0.5.0

v0.4.1

CAMARA Device Status API v0.4.1

This is the second pre-release of the CAMARA Device Status API

• API definition
• API documentation

Please note:

• This is a pre-release version, and should be considered as a draft for further development
• There are bug fixes and breaking changes to be expected in later versions
• The release is suitable for test implementations, but it is not recommended for use in production environments

Added

• Add new return parameters MCC (Mobile Country Code) and ISO 3166-1 alpha-2 Country Code by @ravindrapalaskar17 in #21

Changed

• API simplified by @monamok in #23
  • base path renamed to device-status
  • /status path renamed to /roaming
  • required status type is now implicit from path name, and does not need to be passed by parameter eventType

Fixed

• Fix typo in filename and in CountryName response field by @ravindrapalaskar17 in #30

Removed

• Objects ConnectivityEventType and EventStatusType

New Contributors

• @ravindrapalaskar17 made their first contribution in #21

Full Changelog: v0.2.0...v0.4.1

v0.2.0

CAMARA Device Status API v0.2.0

This is the first pre-release of the CAMARA Device Status API

• API definition
• API documentation

Please note:

• This is a pre-release version, and should be considered as a draft for further development
• There are bug fixes and breaking changes to be expected in later versions
• The release is suitable for test implementations, but it is not recommended for use in production environments

Added

• Initial contribution of API spec check-device-connectivity v0.2.0 by @akoshunyadi in #5
• Upload Roaming API Proposal - Vodafone.md by @eric-murray in #12
• Add documentation by @paweltalar in #8

Changed

• This is the first pre-release

Fixed

• This is the first pre-release

Removed

• This is the first pre-release

New Contributors

• @eric-murray made their first contribution in #1
• @JoachimDahlgren made their first contribution in #3
• @akoshunyadi made their first contribution in #5
• @paweltalar made their first contribution in #8
• @shilpa-padgaonkar made their first contribution in #13
• @NoelWirzius made their first contribution in #16

Full Changelog: https://github.com/camaraproject/DeviceStatus/commits/v0.2.0