search

admin-shell-io / aas-specs-api

Repository of the Asset Administration Shell Specification DTA-01002 API
https://admin-shell-io.github.io/aas-specs-antora/index/home/index.html
Creative Commons Attribution 4.0 International
12 stars 5 forks source link

in consistent handling of GetSelfDescription and GetDescription #304

Open BirgitBoss opened 4 months ago

BirgitBoss commented 4 months ago

What happens?

In https://app.swaggerhub.com/apis/Plattform_i40/SubmodelServiceSpecification/V3.0.2_SSP-001#/Description%20API/GetDescription

the operationID is "GetDescription". However the logical name of the operation is "GetSelfDescription"

The ID is https://admin-shell.io/aas/API/GetSelfDescription/3/0 not https://admin-shell.io/aas/API/Descriptor/GetDescription/3/0 like in openAPI

In all the profiles the logical name "GetDescription" is only used conformant to operationId in openAPI but inconsitent to specification.

How should it be fixed?

Either rename GetSelfDescription to GetDescription or vice versa and update documentation accordingly. ...