diff --git a/CHANGELOG.md b/CHANGELOG.md index 6b0b804..14e9e60 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,50 +1,88 @@ -# Changelog +# Changelog Number Verification API -## v0.4.0-wip [Work in Progress] -## Please note: +## Table of contents -- This is *work-in-progress* 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-wip were used during the development of this version but not released +- **[r1.1](#r11)** +- [v0.3.1](#v031) + + +**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.** + + + +# r1.1 - rc + +## Release Notes + +This release contains the definition and documentation of +* Number Verification API 1.0.0-rc.1 + + + +The API definition(s) are based on +* Commonalities v0.4.0 +* Identity and Consent Management v0.2.0 + + +## Number Verification v1.0.0-rc.1 + + +**number-verification 1.0.0-rc.1** is the first release-candidate version for the v1.0.0 of the number verification API. + +- API definition **with inline documentation**: + - OpenAPI [YAML spec file](https://github.com/camaraproject/NumberVerification/blob/r1.1/code/API_definitions/number_verification.yaml) + - [View it on ReDoc](https://redocly.github.io/redoc/?url=https://raw.githubusercontent.com/camaraproject/NumberVerification/r1.1/code/API_definitions/number_verification.yaml&nocors) + - [View it on Swagger Editor](https://editor.swagger.io/?url=https://raw.githubusercontent.com/camaraproject/NumberVerification/r1.1/code/API_definitions/number_verification.yaml) + +**number-verification 1.0.0-rc.1 is the first stable version for CAMARA Number Verification API** + +This version contains significant changes compared to v0.3.1, and it is not backward compatible. ### Added -- Merge pull request #58 from fernandopradocabrillo/update-documentation-and-remove-deprecated-files -- include documentation inside yaml file, remove deprecated files and fix image link -- Merge pull request #57 from fernandopradocabrillo/update-tef-codeowners -- update codeowners from Telefónica -- Merge pull request #56 from camaraproject/bigludo7-patch-1 -- Merge pull request #58 from fernandopradocabrillo/update-documentation-and-remove-deprecated-files -- include documentation inside yaml file, remove deprecated files and fix image link -- Merge pull request #57 from fernandopradocabrillo/update-tef-codeowners -- update codeowners from Telefónica -- Merge pull request #56 from camaraproject/bigludo7-patch-1 -- Update number_verification.yaml -- Merge pull request #53 from DT-DawidWroblewski/main -- update to yaml -- Merge branch 'main' of https://github.com/DT-DawidWroblewski/NumberVerification -- adding fixes to PR -- Merge pull request #52 from jlurien/chore/replace-polymorphism-requestBody -- Replace polymorphism in requestBody of POST /verify -- Update documentation/API_documentation/README.MD -- Merge pull request #50 from monamok/chore/update_documentation -- cleaning repo -- Relevant definition section added -- Merge pull request #43 from monamok/chore/phone_number_description_alignment -- error code copy/pase typo removed -- updating uml url -- phoneNumber descriptions aligned to the other APIs +* User Story in documentation/API_documentation directory by @bigludo7 [PR118](https://github.com/camaraproject/NumberVerification/pull/118) +* Test Definition in Test_Definitions directory [To be done] ### Changed -* N/A +* Aligned with CAMARA design guidelines & Identity Consent management +* Make the '+' mandatory for the phone number by @fernandopradocabrillo [PR90](https://github.com/camaraproject/NumberVerification/pull/90) +* Cosmetic change following megalinter integration by @bigludo7 [PR103](https://github.com/camaraproject/NumberVerification/pull/103) +* Update Authorization and authentication part accordingly to ICM by @fernandopradocabrillo [PR88](https://github.com/camaraproject/NumberVerification/issues/88) +* Adding a pattern for PhoneNumber in /verify by @maxl2287 [PR68](https://github.com/camaraproject/NumberVerification/issues/76) +* Clarify use of 'user' and 'subscriber' wording by @AxelNennker [PR102](https://github.com/camaraproject/NumberVerification/pull/102) ### Fixed -* N/A +* Replaced OAuth2 auth code flow by OIDC auth code flow by @AxelNennker [PR109](https://github.com/camaraproject/NumberVerification/pull/109) ### Removed -* N/A \ No newline at end of file +* n/a + +## New Contributors + +- @AxelNennker made their first contribution in clarifying use of 'user' and 'subscriber' wording by @AxelNennker [PR102](https://github.com/camaraproject/NumberVerification/pull/102) +- @rartych made their first contribution in GitHub workflows [#108](https://github.com/camaraproject/NumberVerification/pull/108) +- @fernandopradocabrillo made their first contribution by updating Authorization and authentication part accordingly to ICM [PR88](https://github.com/camaraproject/NumberVerification/issues/88) +- @maxl2287 made their first contribution by adding a pattern for PhoneNumber in /verify [PR68](https://github.com/camaraproject/NumberVerification/issues/76) +- @bigludo7 made their first contribution by making change following megalinter integration [PR103](https://github.com/camaraproject/NumberVerification/pull/103) + +**Full Changelog**: https://github.com/camaraproject/NumberVerification/compare/v0.3.1...r1.1 + +## v0.3.1 + +Initital release of Camara Number Verification API + +## What's Changed +* Telefonica Proposal by @monamok in https://github.com/camaraproject/NumberVerification/pull/3 +* Adding API documentation by @monamok in https://github.com/camaraproject/NumberVerification/pull/6 +* Initial content for Number Verify by @DT-DawidWroblewski in https://github.com/camaraproject/NumberVerification/pull/2 +* New specific 403 token error and guidelines alignment by @monamok in https://github.com/camaraproject/NumberVerification/pull/19 +* adding puml by @DT-DawidWroblewski in https://github.com/camaraproject/NumberVerification/pull/24 +* guidelines alignment errors and camel case by @monamok in https://github.com/camaraproject/NumberVerification/pull/30 +* Change 'sub' cardinality + add attribute description by @bigludo7 in https://github.com/camaraproject/NumberVerification/pull/32 +* Embed documentation in API Spec by @monamok in https://github.com/camaraproject/NumberVerification/pull/38 + +**Full Changelog**: https://github.com/camaraproject/NumberVerification/commits/v0.3.1 diff --git a/README.md b/README.md index 9227fc1..bc5754e 100644 --- a/README.md +++ b/README.md @@ -20,17 +20,22 @@ Repository to describe, develop, document and test the NumberVerification API fa ## Meetings -* Meetings are held virtually in Zoom -* Current schedule & meeting links: [Meetings information](documentation/MeetingMinutes/README.MD) +* Current schedule, registration, & meeting links are available on the confluence page: [Meetings information](https://wiki.camaraproject.org/display/CAM/NumberVerification) + -## Results -* Sub Project is in progress ## Status and released versions * Note: 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 a new release is created. For example, changes may be reverted before a release is created. **For best results, use the latest available release**. -* **The latest available release and version of CAMARA NumberVerification API is 0.3.1. This is the first alpha version of the API.** There are bug fixes to be expected and incompatible changes in upcoming releases. It is suitable for implementors, but it is not recommended to use the API with customers in productive environments. -* Release 0.3.1 of the API is available within the [release-0.3.1 branch](https://github.com/camaraproject/NumberVerification/tree/release-0.3.1): +* **The latest pre-release of CAMARA Number Verification API is 1.0.0-rc.1 This is the release candidate of the first stable version of the API**. It is suitable for implementors. +* The Release Tag is [r1.1](https://github.com/camaraproject/NumberVerification/releases/tag/r1.1). + - API definition **with inline documentation**: + - OpenAPI [YAML spec file](https://github.com/camaraproject/NumberVerification/blob/r1.1/code/API_definitions/number_verification.yaml) + - [View it on ReDoc](https://redocly.github.io/redoc/?url=https://raw.githubusercontent.com/camaraproject/NumberVerification/r1.1/code/API_definitions/number_verification.yaml&nocors) + - [View it on Swagger Editor](https://editor.swagger.io/?url=https://raw.githubusercontent.com/camaraproject/NumberVerification/r1.1/code/API_definitions/number_verification.yaml) + + +* The previous version 0.3.1 is available within the [release-0.3.1 branch](https://github.com/camaraproject/NumberVerification/tree/release-0.3.1): - API definition **with inline documentation**: - OpenAPI [YAML spec file](https://github.com/camaraproject/NumberVerification/blob/release-0.3.1/code/API_definitions/CAMARA/number_verification.yaml) - [View it on ReDoc](https://redocly.github.io/redoc/?url=https://raw.githubusercontent.com/camaraproject/NumberVerification/release-0.3.1/code/API_definitions/CAMARA/number_verification.yaml&nocors) @@ -41,3 +46,8 @@ Repository to describe, develop, document and test the NumberVerification API fa * To subscribe / unsubscribe to the mailing list of this Sub Project and thus be / resign as Contributor please visit . * A message to all Contributors of this Sub Project can be sent using . + + +## Relevant Information + +Since April 4th 2024 WG meeting minutes are placed in [Number Verification Wiki Confluence site](https://wiki.camaraproject.org/display/CAM/Number+Verification) diff --git a/code/API_definitions/number_verification.yaml b/code/API_definitions/number_verification.yaml index bb22edd..4903f05 100644 --- a/code/API_definitions/number_verification.yaml +++ b/code/API_definitions/number_verification.yaml @@ -50,21 +50,17 @@ info: # Further info and support [GSMA Mobile Connect Verified MSISDN specification](https://www.gsma.com/identity/wp-content/uploads/2022/12/IDY.54-Mobile-Connect-Verified-MSISDN-Definition-and-Technical-Requirements-1.0.pdf) was used as source of input for this API. For more about Mobile Connect, please see [Mobile Connect website](https://mobileconnect.io/). - version: wip - termsOfService: http://example.com/terms/ - contact: - name: API Support - url: http://www.example.com/support - email: support@example.com + version: 1.0.0-rc.1 + x-camara-commonalities: 0.4.0 license: name: Apache 2.0 url: https://www.apache.org/licenses/LICENSE-2.0.html servers: - - url: '{apiRoot}/number-verification/v0' + - url: '{apiRoot}/number-verification/v1rc1' variables: apiRoot: default: http://localhost:9091 - description: API root + description: API root, defined by the service provider, e.g. `api.example.com` or `api.example.com/somepath tags: - name: Phone number verify description: API operation to verify a phone number received as input. It can be received either in plain text or hashed format. diff --git a/documentation/API_documentation/NumberVerification-Readiness-Checklist.md b/documentation/API_documentation/NumberVerification-Readiness-Checklist.md new file mode 100644 index 0000000..d00b0b8 --- /dev/null +++ b/documentation/API_documentation/NumberVerification-Readiness-Checklist.md @@ -0,0 +1,28 @@ +# API Readiness Checklist + +Checklist for number_verification 1.0.0-rc.1 in release r1.1 + +| Nr | API release assets | alpha | release-candidate | public-release
initial | public-release
stable | Status | Comments | +|----|----------------------------------------------|:-----:|:-----------------:|:-------:|:------:|:----:|:----:| +| 1 | API definition | M | M | M | M | Y | [link](/code/API_definitions/number_verification.yaml) | +| 2 | Design guidelines from Commonalities applied | O | M | M | M | Y | | +| 3 | Guidelines from ICM applied | O | M | M | M | Y | | +| 4 | API versioning convention applied | M | M | M | M | Y | | +| 5 | API documentation | M | M | M | M | Y | Embed documentation into API spec - [link](/code/API_definitions/number_verification.yaml) | +| 6 | User stories | O | O | O | M | tbd | [PR #129](https://github.com/camaraproject/NumberVerification/pull/129/files) | +| 7 | Basic API test cases & documentation | O | M | M | M | tbd | [PR #124](https://github.com/camaraproject/NumberVerification/pull/124/files) | +| 8 | Enhanced API test cases & documentation | O | O | O | M | tbd | [PR #124](https://github.com/camaraproject/NumberVerification/pull/124/files) | +| 9 | Test result statement | O | O | O | M | tbd | link | + +| 10 | API release numbering convention applied | M | M | M | M | Y | | +| 11 | Change log updated | M | M | M | M | N | [link](/CHANGELOG.md) | +| 12 | Previous public-release was certified | O | O | O | M | Y | | + +To fill the checklist: +- in the line above the table, replace the api-name, api-version and the rx.y by their actual values for the current API version and release. +- in the Status column, put "Y" (yes) if the release asset is available or fulfilled in the current release, a "N" (no) or a "tbd". Example use of "tbd" is in case an alpha or release-candidate API version does not yet provide all mandatory assets for the release. +- in the Comments column, provide the link to the asset once available, and any other relevant comments. + +Note: the checklists of a public API version and of its preceding release-candidate API version can be the same. + +The documentation for the content of the checklist is here: [API Readiness Checklist](https://wiki.camaraproject.org/display/CAM/API+Release+Process#APIReleaseProcess-APIreadinesschecklist).