From 84b8c7ac66cd91f8ea5fed93431fa3bb2abcf521 Mon Sep 17 00:00:00 2001 From: Aaron Zielstorff Date: Thu, 21 May 2026 16:54:52 +0200 Subject: [PATCH 1/2] Removes wrong 404 status code for getAllSubmodelDescriptors --- Entire-API-Collection/V3.2.yaml | 4 +--- .../V3.2_SSP-001.yaml | 4 +--- .../V3.2_SSP-002.yaml | 4 +--- .../IDTA-01002-3/modules/ROOT/pages/changelog.adoc | 14 ++++++++++++++ 4 files changed, 17 insertions(+), 9 deletions(-) diff --git a/Entire-API-Collection/V3.2.yaml b/Entire-API-Collection/V3.2.yaml index 420f80bb..bc3c4e5f 100644 --- a/Entire-API-Collection/V3.2.yaml +++ b/Entire-API-Collection/V3.2.yaml @@ -7058,9 +7058,7 @@ paths: '400': $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/responses/bad-request' '403': - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/responses/forbidden' - '404': - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/responses/not-found' + $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.2#/components/responses/forbidden' '500': $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/responses/internal-server-error' default: diff --git a/SubmodelRegistryServiceSpecification/V3.2_SSP-001.yaml b/SubmodelRegistryServiceSpecification/V3.2_SSP-001.yaml index 44edea16..bd4c9090 100644 --- a/SubmodelRegistryServiceSpecification/V3.2_SSP-001.yaml +++ b/SubmodelRegistryServiceSpecification/V3.2_SSP-001.yaml @@ -38,9 +38,7 @@ paths: '400': $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/responses/bad-request' '403': - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/responses/forbidden' - '404': - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/responses/not-found' + $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.2#/components/responses/forbidden' '500': $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/responses/internal-server-error' default: diff --git a/SubmodelRegistryServiceSpecification/V3.2_SSP-002.yaml b/SubmodelRegistryServiceSpecification/V3.2_SSP-002.yaml index 967c2f5d..72484ed3 100644 --- a/SubmodelRegistryServiceSpecification/V3.2_SSP-002.yaml +++ b/SubmodelRegistryServiceSpecification/V3.2_SSP-002.yaml @@ -38,9 +38,7 @@ paths: '400': $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/responses/bad-request' '403': - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/responses/forbidden' - '404': - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/responses/not-found' + $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.2#/components/responses/forbidden' '500': $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.2.0#/components/responses/internal-server-error' default: diff --git a/documentation/IDTA-01002-3/modules/ROOT/pages/changelog.adoc b/documentation/IDTA-01002-3/modules/ROOT/pages/changelog.adoc index f3a04ced..e46aa832 100644 --- a/documentation/IDTA-01002-3/modules/ROOT/pages/changelog.adoc +++ b/documentation/IDTA-01002-3/modules/ROOT/pages/changelog.adoc @@ -9,6 +9,20 @@ Note: Changes in Metamodel (IDTA-01001) will not be listed here, although they have an impact on the payload of many operations. ==== +== Changes w.r.t. V3.1.2 to V3.1.3 + +Major Changes: + +* ... + + +Minor Changes: + +* Fixed the response payload type of `PutSubmodelById` in the Asset Administration Shell Repository OpenAPI files: status code `201` now returns a `Submodel` instead of a `Reference`. (https://github.com/admin-shell-io/aas-specs-api/issues/601[#601]) +* Updated the response contract of `PostAllAssetLinksById` in Discovery OpenAPI files by removing status code `404` for `POST /lookup/shells/{aasIdentifier}` to align with create-or-replace semantics. (https://github.com/admin-shell-io/aas-specs-api/issues/595[#595]) +* Updated the response contract of `PostAllAssetLinksById` in Discovery OpenAPI files by removing status code `409` for `POST /lookup/shells/{aasIdentifier}` to align with replace/update behavior on repeated payloads. (https://github.com/admin-shell-io/aas-specs-api/issues/596[#596]) +* Updated the response contract of `GetAllSubmodelDescriptors` in Submodel Registry OpenAPI files by removing status code `404` for `GET /submodel-descriptors`, so an empty collection is consistently represented by `200` with an empty result. (https://github.com/admin-shell-io/aas-specs-api/issues/597[#597]) + == Changes w.r.t. V3.1.2 to V3.2 From 47fd6fb938e0d0a73c2edaed6465370a12c02719 Mon Sep 17 00:00:00 2001 From: Aaron Zielstorff Date: Thu, 21 May 2026 19:07:00 +0200 Subject: [PATCH 2/2] Fixes changelog --- .../modules/ROOT/pages/changelog.adoc | 28 +++++++++---------- 1 file changed, 14 insertions(+), 14 deletions(-) diff --git a/documentation/IDTA-01002-3/modules/ROOT/pages/changelog.adoc b/documentation/IDTA-01002-3/modules/ROOT/pages/changelog.adoc index e46aa832..da119a3a 100644 --- a/documentation/IDTA-01002-3/modules/ROOT/pages/changelog.adoc +++ b/documentation/IDTA-01002-3/modules/ROOT/pages/changelog.adoc @@ -9,20 +9,6 @@ Note: Changes in Metamodel (IDTA-01001) will not be listed here, although they have an impact on the payload of many operations. ==== -== Changes w.r.t. V3.1.2 to V3.1.3 - -Major Changes: - -* ... - - -Minor Changes: - -* Fixed the response payload type of `PutSubmodelById` in the Asset Administration Shell Repository OpenAPI files: status code `201` now returns a `Submodel` instead of a `Reference`. (https://github.com/admin-shell-io/aas-specs-api/issues/601[#601]) -* Updated the response contract of `PostAllAssetLinksById` in Discovery OpenAPI files by removing status code `404` for `POST /lookup/shells/{aasIdentifier}` to align with create-or-replace semantics. (https://github.com/admin-shell-io/aas-specs-api/issues/595[#595]) -* Updated the response contract of `PostAllAssetLinksById` in Discovery OpenAPI files by removing status code `409` for `POST /lookup/shells/{aasIdentifier}` to align with replace/update behavior on repeated payloads. (https://github.com/admin-shell-io/aas-specs-api/issues/596[#596]) -* Updated the response contract of `GetAllSubmodelDescriptors` in Submodel Registry OpenAPI files by removing status code `404` for `GET /submodel-descriptors`, so an empty collection is consistently represented by `200` with an empty result. (https://github.com/admin-shell-io/aas-specs-api/issues/597[#597]) - == Changes w.r.t. V3.1.2 to V3.2 @@ -76,6 +62,20 @@ h|Operation h|Kind of Change h|Comment |=== +== Changes w.r.t. V3.1.2 to V3.1.3 + +Major Changes: + +* ... + + +Minor Changes: + +* Fixed the response payload type of `PutSubmodelById` in the Asset Administration Shell Repository OpenAPI files: status code `201` now returns a `Submodel` instead of a `Reference`. (https://github.com/admin-shell-io/aas-specs-api/issues/601[#601]) +* Updated the response contract of `PostAllAssetLinksById` in Discovery OpenAPI files by removing status code `404` for `POST /lookup/shells/{aasIdentifier}` to align with create-or-replace semantics. (https://github.com/admin-shell-io/aas-specs-api/issues/595[#595]) +* Updated the response contract of `PostAllAssetLinksById` in Discovery OpenAPI files by removing status code `409` for `POST /lookup/shells/{aasIdentifier}` to align with replace/update behavior on repeated payloads. (https://github.com/admin-shell-io/aas-specs-api/issues/596[#596]) +* Updated the response contract of `GetAllSubmodelDescriptors` in Submodel Registry OpenAPI files by removing status code `404` for `GET /submodel-descriptors`, so an empty collection is consistently represented by `200` with an empty result. (https://github.com/admin-shell-io/aas-specs-api/issues/597[#597]) + == Changes w.r.t. V3.1.1 to V3.1.2