diff --git a/AssetAdministrationShellRepositoryServiceSpecification/V3.1_SSP-001.yaml b/AssetAdministrationShellRepositoryServiceSpecification/V3.1_SSP-001.yaml index 3ee4e49d..6938ffc4 100644 --- a/AssetAdministrationShellRepositoryServiceSpecification/V3.1_SSP-001.yaml +++ b/AssetAdministrationShellRepositoryServiceSpecification/V3.1_SSP-001.yaml @@ -540,7 +540,7 @@ paths: required: true responses: '201': - description: Submodel reference created successfully + description: Submodel created successfully headers: Location: description: URL of the newly created resource @@ -549,7 +549,7 @@ paths: content: application/json: schema: - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part1-MetaModel-Schemas/V3.1.2#/components/schemas/Reference' + $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part1-MetaModel-Schemas/V3.1.2#/components/schemas/Submodel' '204': description: Submodel updated successfully '400': diff --git a/DiscoveryServiceSpecification/V3.1_SSP-001.yaml b/DiscoveryServiceSpecification/V3.1_SSP-001.yaml index 7262345a..e656a23b 100644 --- a/DiscoveryServiceSpecification/V3.1_SSP-001.yaml +++ b/DiscoveryServiceSpecification/V3.1_SSP-001.yaml @@ -135,10 +135,6 @@ paths: $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part1-MetaModel-Schemas/V3.1.2#/components/schemas/SpecificAssetId' '400': $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.2#/components/responses/bad-request' - '404': - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.2#/components/responses/not-found' - '409': - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.2#/components/responses/conflict' default: $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.2#/components/responses/default' delete: diff --git a/Entire-API-Collection/V3.1.yaml b/Entire-API-Collection/V3.1.yaml index 383f5c5c..bcc5faa8 100644 --- a/Entire-API-Collection/V3.1.yaml +++ b/Entire-API-Collection/V3.1.yaml @@ -6954,8 +6954,6 @@ paths: $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.2#/components/responses/bad-request' '403': $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.2#/components/responses/forbidden' - '404': - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.2#/components/responses/not-found' '500': $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.2#/components/responses/internal-server-error' default: @@ -7313,10 +7311,6 @@ paths: $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part1-MetaModel-Schemas/V3.1.2#/components/schemas/SpecificAssetId' '400': $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.2#/components/responses/bad-request' - '404': - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.2#/components/responses/not-found' - '409': - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.2#/components/responses/conflict' default: $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.2#/components/responses/default' delete: diff --git a/SubmodelRegistryServiceSpecification/V3.1_SSP-001.yaml b/SubmodelRegistryServiceSpecification/V3.1_SSP-001.yaml index 02c7a3ab..b8aa9fb1 100644 --- a/SubmodelRegistryServiceSpecification/V3.1_SSP-001.yaml +++ b/SubmodelRegistryServiceSpecification/V3.1_SSP-001.yaml @@ -39,8 +39,6 @@ paths: $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.2#/components/responses/bad-request' '403': $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.2#/components/responses/forbidden' - '404': - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.2#/components/responses/not-found' '500': $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.2#/components/responses/internal-server-error' default: diff --git a/SubmodelRegistryServiceSpecification/V3.1_SSP-002.yaml b/SubmodelRegistryServiceSpecification/V3.1_SSP-002.yaml index d300a487..4c579b58 100644 --- a/SubmodelRegistryServiceSpecification/V3.1_SSP-002.yaml +++ b/SubmodelRegistryServiceSpecification/V3.1_SSP-002.yaml @@ -39,8 +39,6 @@ paths: $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.2#/components/responses/bad-request' '403': $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.2#/components/responses/forbidden' - '404': - $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.2#/components/responses/not-found' '500': $ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part2-API-Schemas/V3.1.2#/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 05f7bfd0..90b9d400 100644 --- a/documentation/IDTA-01002-3/modules/ROOT/pages/changelog.adoc +++ b/documentation/IDTA-01002-3/modules/ROOT/pages/changelog.adoc @@ -9,6 +9,21 @@ 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]) +* Submodel Service Specification – Read Profile had the wrong identifier `https://admin-shell.io/aas/API/3/1/AssetAdministrationShellServiceSpecification/SSP-002` instead of https://admin-shell.io/aas/API/3/1/SubmodelServiceSpecification/SSP-002` + == Changes w.r.t. V3.1.1 to V3.1.2 diff --git a/documentation/IDTA-01002-3/modules/ROOT/pages/http-rest-api/service-specifications-and-profiles.adoc b/documentation/IDTA-01002-3/modules/ROOT/pages/http-rest-api/service-specifications-and-profiles.adoc index bfcf4d1f..8296ce81 100644 --- a/documentation/IDTA-01002-3/modules/ROOT/pages/http-rest-api/service-specifications-and-profiles.adoc +++ b/documentation/IDTA-01002-3/modules/ROOT/pages/http-rest-api/service-specifications-and-profiles.adoc @@ -254,7 +254,7 @@ The submodel service specification with its minimal feature set is represented t [%autowidth,width="100%",cols="36%,64%",options="header",] |=== h|Name: h|Submodel Read Profile -h|Profile Identifier: |`\https://admin-shell.io/aas/API/3/1/AssetAdministrationShellServiceSpecification/SSP-002` +h|Profile Identifier: |`\https://admin-shell.io/aas/API/3/1/SubmodelServiceSpecification/SSP-002` h|Feature h|Appearance |API and API Operations a| _Submodel API:_ +