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

What is a valid endpointAddress when the endpoint interface is AAS-REPOSITORY #300

Open o-st opened 4 months ago

o-st commented 4 months ago

I want to provide an endpoint to a shell residing inside a shell repository. What is the correct way to specify the endpointAddress?

The standard provides only the following example:

{
  "protocolInformation": {
    "endpointAddress": "https://localhost:1234",
    "endpointProtocolVersion: "1.1"
  },
  "interface": "AAS-3.0"
}

If I have a shell with the identifier https://test-shell residing in a shell repository, the HTTP endpoint to retrieve the shell would be located at https://.../my-shell-repo/shells/aHR0cHM6Ly90ZXN0LXNoZWxs.

When using AAS-REPOSITORY-3.0 for the interface attribute of the endpoint, would the correct endpointAddress be

  1. https://.../my-shell-repo/shells/aHR0cHM6Ly90ZXN0LXNoZWxs (the URL where the shell data is located)
  2. https://.../my-shell-repo/ (the base URL of my shell repository)

Both cases seem valid to me and I could not find anything about this in the standard. However, there has to be one "correct" solution, because clients receiving endpoint data need to be able to deal with it in a unified way.