r1.3

Release Notes

This release contains the definition and documentation of

• sim-swap 1.0.0
• sim-swap-subscriptions 0.1.1

The API definition(s) are based on

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

sim-swap 1.0.0

sim-swap 1.0.0 is the public release for v1.0.0 of the Sim Swap API.

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

Main Changes

• This release only contains and update for the test plan to cover scenarios where no sim swap occurred

Fixed

• Update test plan by @fernandopradocabrillo in #159

Sim Swap Subscriptions v0.1.1

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

Main Changes

• Fixed an schema reference that prevented the createSimSwapSubscription operation callback request body to render properly

Fixed

• Add EventSimSwap to Sim Swap Subscriptions by @daniel-dierich in #157

New Contributors

• @daniel-dierich made their first contribution in #157

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

r1.2

Release Notes

This release contains the definition and documentation of

• sim-swap 1.0.0
• sim-swap-subscriptions 0.1.0

The API definition(s) are based on

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

sim-swap 1.0.0

sim-swap 1.0.0 is the public release for v1.0.0 of the Sim Swap API.

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

Main Changes

• API and test definitions updated to conform to the Commonalities v0.4.0 and Identity and Consent Management v0.2.0 guidelines included in the CAMARA Fall24 meta-release
• Additional documentation & test cases added.

Added

• User Story in documentation/API_documentation directory by @jgarciahospital PR125
• Test Definition in Test_Definitions directory by @fernandopradocabrillo PR70
• Added the API name sim-swap as a scope to request access to both available endpoints by @AxelNennker in #103

Changed

• Made response properties latestSimChange and swapped required since they will always be returned by @fernandopradocabrillo in #97
• Updated pattern to make the '+' mandatory for phoneNumber by @bigludo7 in #100
• Replaced "MSISDN" with "phone number" in descriptions to follow Commonalities guidelines by @gregory1g in #116
• Removed unused errors and align with Commonalities error definitions by @fernandopradocabrillo in #126

Fixed

• N/A

Removed

• N/A

New Contributors

• N/A

Sim Swap Subscriptions v0.1.0

sim-swap-subscriptions v0.1.0 is the first initial version for the CAMARA Sim Swap Subscriptions API

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

Main Changes

• Initial contribution of the API definition for Sim Swap Subscriptions allowing API consumers to subscribe to get notified when a sim swap occurs on a device.
• API and test definitions updated to conform to the Commonalities v0.4.0 and Identity and Consent Management v0.2.0 guidelines included in the CAMARA Fall24 meta-release
• Test cases added.

Added

• Initial yaml contribution by @bigludo7 PR60
• Test Definition in Test_Definitions directory by @bigludo7 PR147

Changed

• N/A

Fixed

• N/A

Removed

• N/A

New Contributors

• N/A

Full Changelog: v0.4.0...r1.2

r1.1

Release Notes

This release contains the definition and documentation of

• Sim Swap API 1.0.0-rc.1
• Sim Swap Subscriptions v0.1.0-alpha.1

The API definition(s) are based on

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

Sim Swap v1.0.0-rc.1

sim-swap 1.0.0-rc.1 is the first release-candidate version for the v1.0.0 of the Sim Swap API
This version contains significant changes compared to v0.4.0, and it is not backward compatible.

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

Added

• User Story in documentation/API_documentation directory by @jgarciahospital PR125
• Test Definition in Test_Definitions directory by @fernandopradocabrillo PR70
• add API-Name aka wild-card scope by @AxelNennker in #103

Changed

• Make response properties "latestSimChange" and "swapped" required since they will always be returned Issue 96
• Update SIM Swap & SIM Swap notification subscription yaml to make the '+' mandatory for phoneNumber by @bigludo7 in #100
• phone number instead of MSISDN to follow communalities guidelines by @gregory1g in #116
• Remove unused errors and align with commonalities errors by @fernandopradocabrillo in #126

Removed

• n/a

Sim Swap Subscriptions v0.1.0-alpha.1

sim-swap-subscriptions v0.1.0-alpha.1 is the first alpha version for CAMARA Sim Swap subscription 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 API version is suitable for test implementations and has the purpose to collect feedback for its further development. It should not be used with customers in productive environments.

Added

• Add a new API to manage sim swap notification subscription & notification. by @bigludo7 PR60
• Add subscriptionMaxEvents for maximum number of SIMSwap notifications by @bigludo7 PR91
• Update SIM Swap notification subscription yaml to make the '+' mandatory for phoneNumber by @bigludo7 in PR100
• align subscription model accordingly to the new format defined in Commonalities. This format is aligned with CloudEvents. Fixes examples for phoneNumber by @bigludo7 in PR111

Changed

• n/a

Removed

• n/a

New Contributors

• @trehman-gsma made their first contribution in #62
• @gregory1g made their first contribution in #82
• @rartych made their first contribution in #110
• @AxelNennker made their first contribution in #103

Full Changelog: v0.4.0...r1.1

v0.4.0

Table of Contents

• v0.4.0

v0.4.0

This is the first alpha release of the CAMARA SimSwap 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
• Version numbers before v0.4.0 were used during the development of this version but not released
• GSMA Mobile Connect Account Takeover Protection specification was used as source of input for this API. For more about Mobile Connect, please see Mobile Connect website.

What's Changed

• SimSwap OAS with 2 endpoints (check & get date) by @bigludo7 in #7
• Added API documentation for the 2-endpoints SIM Swap API by @bigludo7 in #9
• Reshaping the content (+readme.md update) by @DT-DawidWroblewski in #13
• Update README.MD by @jlurien in #17
• Guidelines alignment regarding errors and camel case by @monamok in #20
• Glossary alignment by @monamok in #40
• Cleaning up repo by @DT-DawidWroblewski in #48
• Created a release branch release-0.4.0 based on commit 6843563
• Fixed the security schema as agreed to three-legged only within the release branch
• Created CHANGELOG.md and updated README.md within the release branch

New Contributors

• @monamok made their first contribution in #3
• @DT-DawidWroblewski made their first contribution in #8
• @bigludo7 made their first contribution in #7
• @jlurien made their first contribution in #17
• @fernandopradocabrillo made their first contribution in #46

Full Changelog: https://github.com/camaraproject/SimSwap/commits/v0.4.0