Skip to content

Commit 6c22e6f

Browse files
authored
extend the explanation how to discover endpoints (#443)
1 parent e146747 commit 6c22e6f

File tree

2 files changed

+4
-1
lines changed

2 files changed

+4
-1
lines changed

documentation/IDTA-01002-3/modules/ROOT/pages/changelog.adoc

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -50,6 +50,7 @@ Minor Changes:
5050
* add xref:annex/overview-constraints.adoc[overview of constraints] to Annex
5151
* xref:http-rest-api/http-rest-api.adoc#design-decisions[Design Decisions for the HTTP API]: Clarify that padding is not allowed for base64url-encoded values (https://github.com/admin-shell-io/aas-specs-api/issues/423[#423])
5252
* xref:http-rest-api/http-rest-api.adoc#modifier-constraints[HTTP Modifier Constraints]: adding note for metadata and value-only representations of Asset Administration Shells (https://github.com/admin-shell-io/aas-specs-api/issues/268[#268])
53+
* xref:http-rest-api/interactions.adoc[Interactions]: extending the explanation how to discover endpoints of AAS services
5354

5455
=== Interface Changes w.r.t. V3.0.4 to V3.1
5556

documentation/IDTA-01002-3/modules/ROOT/pages/http-rest-api/interactions.adoc

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,9 @@ Constraints and assumptions for calling an AAS and a submodel operation by a cli
2222

2323
* The calling application has to be aware that endpoints may change at any time.
2424
If the application has cached an endpoint that is no longer vivid, the application needs to start the interaction to resolve the appropriate endpoint again from the beginning.
25-
* Endpoints for infrastructure interfaces like AAS registries are known at design time of the client application or configured manually before start-up.
25+
* Several ways are possible to get to know the endpoints for the infrastructure interfaces of AAS Discovery and/or Registries before calling the APIs. Some examples:
26+
- A discovery service for dataspace connectors as well as endpoints for AAS services can be found as part of the registered applications on a connector, as e.g. specified in the Catena-X dataspace.
27+
- The endpoints can be configured in the application during start or dynamically at runtime by a user.
2628
* The asset IDs (either the global asset ID or some specific asset IDs) are known to the calling application.
2729
* Access to any API is allowed only if the caller is authenticated.
2830
* Response to any API call takes access rules as defined for the services into account, e.g. access rules for the AASs, the Submodels, or SubmodelElements within a Submodel.

0 commit comments

Comments
 (0)