Asset Administration Shell Registry Service Specification Profile SSP-001 Version 3.0 (V3.0.3_SSP-001)

Download OpenAPI specification:Download

Attribution 1

Title: CX-0002 DIGITAL TWINS IN CATENA-X Version 2.0

Publisher: Catena-X Automotive Network e.V.

Attribution 2

Title: Asset Administration Shell Registry Service Specification Profile SSP-001 Version 3.0

Publisher: Industrial Digital Twin Association e.V.

Source: https://app.swaggerhub.com/apis/Plattform_i40/AssetAdministrationShellRegistryServiceSpecification/V3.0.2_SSP-001

License: CC BY 4.0

Asset Administration Shell Registry

Returns all Asset Administration Shell Descriptors

path Parameters

tenantId

required

string <uuid>

Unique identifier of the owning tenant.

query Parameters

limit	integer >= 1 The maximum number of elements in the response array
cursor	string A server-generated identifier retrieved from pagingMetadata that specifies from which position the result listing should continue
assetKind	string (AssetKind) Enum: "Instance" "NotApplicable" "Role" "Type" The Asset's kind (Instance or Type)
assetType	string [ 1 .. 2000 ] characters ^([\x09\x0a\x0d\x20-\ud7ff\ue000-\ufffd]\|\ud8... The Asset's type (UTF8-BASE64-URL-encoded)
select	string Define an RQL select option, read more
filter	string Define an RQL filter query, read more
option	string Define an RQL sort option, read more

header Parameters

Edc-Bpn

string

The external subject id (bpn) indicates which tenant is allowed to see the specificAssetId and find a Shell. Using this header requires separate OAuth2 role 'AAS EDC BPN Viewer', consult the docs for more information.

Responses

Response samples

200
400
403
500
default

Content type

application/json

{"paging_metadata": {"cursor": "wJlCDLIl6KTWypN7T6vc6nWEmEYe99Hjf1XY1xmqV-M=#"
},
"result": ["{ \"id\": \"https://example.org/aas/motor\" }"
]
}

Creates a new Asset Administration Shell Descriptor, i.e. registers an AAS

path Parameters

tenantId

required

string <uuid>

Unique identifier of the owning tenant.

Request Body schema: application/json
required

Asset Administration Shell Descriptor object

	Array of objects (LangStringTextType) <= 50 items unique
	Array of objects (LangStringNameType) <= 50 items unique
assetKind	string (AssetKind) Enum: "Instance" "NotApplicable" "Role" "Type"
assetType	string [ 1 .. 2000 ] characters ^([\x09\x0a\x0d\x20-\ud7ff\ue000-\ufffd]\|\ud8...
globalAssetId	string [ 1 .. 2000 ] characters ^([\x09\x0a\x0d\x20-\ud7ff\ue000-\ufffd]\|\ud8...
idShort	string [ 1 .. 128 ] characters The idShort is unique.
id required	string [ 1 .. 2000 ] characters ^([\x09\x0a\x0d\x20-\ud7ff\ue000-\ufffd]\|\ud8...
	Array of objects (SpecificAssetId) <= 50 items unique
	Array of objects (SubmodelDescriptor) <= 50 items unique
	Array of objects (ShellGroupIdDto) <= 50 items unique Shell Groups
labels	Array of strings <= 10 items unique Labels of the Shell

Responses

Request samples

Payload

Content type

application/json

"{ \"id\": \"https://example.org/aas/motor\" }"

Response samples

Content type

application/json

"{ \"id\": \"https://example.org/aas/motor\" }"

Returns a specific Asset Administration Shell Descriptor

path Parameters

tenantId required	string <uuid> Unique identifier of the owning tenant.
aasIdentifier required	string The Asset Administration Shell’s unique id (UTF8-BASE64-URL-encoded)

header Parameters

Edc-Bpn

string

The external subject id (bpn) indicates which tenant is allowed to see the specificAssetId and find a Shell. Using this header requires separate OAuth2 role 'AAS EDC BPN Viewer', consult the docs for more information.

Responses

Response samples

Content type

application/json

"{ \"id\": \"https://example.org/aas/motor\" }"

Updates an existing Asset Administration Shell Descriptor

path Parameters

tenantId required	string <uuid> Unique identifier of the owning tenant.
aasIdentifier required	string The Asset Administration Shell’s unique id (UTF8-BASE64-URL-encoded)

Request Body schema: application/json
required

Asset Administration Shell Descriptor object

	Array of objects (LangStringTextType) <= 50 items unique
	Array of objects (LangStringNameType) <= 50 items unique
assetKind	string (AssetKind) Enum: "Instance" "NotApplicable" "Role" "Type"
assetType	string [ 1 .. 2000 ] characters ^([\x09\x0a\x0d\x20-\ud7ff\ue000-\ufffd]\|\ud8...
globalAssetId	string [ 1 .. 2000 ] characters ^([\x09\x0a\x0d\x20-\ud7ff\ue000-\ufffd]\|\ud8...
idShort	string [ 1 .. 128 ] characters The idShort is unique.
id required	string [ 1 .. 2000 ] characters ^([\x09\x0a\x0d\x20-\ud7ff\ue000-\ufffd]\|\ud8...
	Array of objects (SpecificAssetId) <= 50 items unique
	Array of objects (SubmodelDescriptor) <= 50 items unique
	Array of objects (ShellGroupIdDto) <= 50 items unique Shell Groups
labels	Array of strings <= 10 items unique Labels of the Shell

Responses

Request samples

Payload

Content type

application/json

"{ \"id\": \"https://example.org/aas/motor\" }"

Response samples

400
403
404
500
default

Content type

application/json

{"messages": [{"code": "string",
"correlationId": "string",
"messageType": "Undefined",
"text": "string",
"timestamp": "string"
}
]
}

Deletes an Asset Administration Shell Descriptor, i.e. de-registers an AAS

path Parameters

tenantId required	string <uuid> Unique identifier of the owning tenant.
aasIdentifier required	string The Asset Administration Shell’s unique id (UTF8-BASE64-URL-encoded)

Responses

Response samples

400
404
500
default

Content type

application/json

{"messages": [{"code": "string",
"correlationId": "string",
"messageType": "Undefined",
"text": "string",
"timestamp": "string"
}
]
}

Returns all Submodel Descriptors

path Parameters

tenantId required	string <uuid> Unique identifier of the owning tenant.
aasIdentifier required	string The Asset Administration Shell’s unique id (UTF8-BASE64-URL-encoded)

query Parameters

limit	integer >= 1 The maximum number of elements in the response array
cursor	string A server-generated identifier retrieved from pagingMetadata that specifies from which position the result listing should continue

header Parameters

Edc-Bpn

string

The external subject id (bpn) indicates which tenant is allowed to see the specificAssetId and find a Shell. Using this header requires separate OAuth2 role 'AAS EDC BPN Viewer', consult the docs for more information.

Responses

Response samples

Content type

application/json

{"paging_metadata": {"cursor": "wJlCDLIl6KTWypN7T6vc6nWEmEYe99Hjf1XY1xmqV-M=#"
},
"result": ["{ \"id\": \"https://admin-shell.io/zvei/nameplate/1/0/Nameplate\", \"endpoints\": [ { \"href\": { \"href\": \"https://localhost:1234/api/v3.0/submodel\", \"endpointProtocol\": \"HTTP\", \"endpointProtocolVersion\": [\"1.1\"] }, \"interface\": \"AAS-3.0\" }, { \"protocolInformation\": { \"href\": \"opc.tcp://localhost:4840\" }, \"interface\": \"AAS-3.0\" }, { \"protocolInformation\": { \"href\": \"https://localhost:5678\", \"endpointProtocol\": \"HTTP\", \"endpointProtocolVersion\": [\"1.1\"], \"subprotocol\": \"OPC UA Basic SOAP\", \"subprotocolBody\": \"ns=2;s=MyAAS\", \"subprotocolBodyEncoding\": \"application/soap+xml\" }, \"interface\": \"AAS-3.0\" } ] }"
]
}

Creates a new Submodel Descriptor, i.e. registers a submodel

path Parameters

tenantId required	string <uuid> Unique identifier of the owning tenant.
aasIdentifier required	string The Asset Administration Shell’s unique id (UTF8-BASE64-URL-encoded)

Request Body schema: application/json
required

Submodel Descriptor object

required	Array of objects (Endpoint) [ 1 .. 10000 ] items unique
idShort	string [ 1 .. 128 ] characters The idShort is not unique overall. All Submodel idShort in one Shell are unique.
id required	string [ 1 .. 2000 ] characters ^([\x09\x0a\x0d\x20-\ud7ff\ue000-\ufffd]\|\ud8...
	object (Reference)
	Array of objects (Reference) <= 50 items unique
	Array of objects (LangStringTextType) <= 50 items unique
	Array of objects (LangStringNameType) <= 50 items unique

Responses

Request samples

Payload

Content type

application/json

"{ \"id\": \"https://admin-shell.io/zvei/nameplate/1/0/Nameplate\", \"endpoints\": [ { \"href\": { \"href\": \"https://localhost:1234/api/v3.0/submodel\", \"endpointProtocol\": \"HTTP\", \"endpointProtocolVersion\": [\"1.1\"] }, \"interface\": \"AAS-3.0\" }, { \"protocolInformation\": { \"href\": \"opc.tcp://localhost:4840\" }, \"interface\": \"AAS-3.0\" }, { \"protocolInformation\": { \"href\": \"https://localhost:5678\", \"endpointProtocol\": \"HTTP\", \"endpointProtocolVersion\": [\"1.1\"], \"subprotocol\": \"OPC UA Basic SOAP\", \"subprotocolBody\": \"ns=2;s=MyAAS\", \"subprotocolBodyEncoding\": \"application/soap+xml\" }, \"interface\": \"AAS-3.0\" } ] }"

Response samples

Content type

application/json

"{ \"id\": \"https://admin-shell.io/zvei/nameplate/1/0/Nameplate\", \"endpoints\": [ { \"href\": { \"href\": \"https://localhost:1234/api/v3.0/submodel\", \"endpointProtocol\": \"HTTP\", \"endpointProtocolVersion\": [\"1.1\"] }, \"interface\": \"AAS-3.0\" }, { \"protocolInformation\": { \"href\": \"opc.tcp://localhost:4840\" }, \"interface\": \"AAS-3.0\" }, { \"protocolInformation\": { \"href\": \"https://localhost:5678\", \"endpointProtocol\": \"HTTP\", \"endpointProtocolVersion\": [\"1.1\"], \"subprotocol\": \"OPC UA Basic SOAP\", \"subprotocolBody\": \"ns=2;s=MyAAS\", \"subprotocolBodyEncoding\": \"application/soap+xml\" }, \"interface\": \"AAS-3.0\" } ] }"

Returns a specific Submodel Descriptor

path Parameters

tenantId required	string <uuid> Unique identifier of the owning tenant.
aasIdentifier required	string The Asset Administration Shell’s unique id (UTF8-BASE64-URL-encoded)
submodelIdentifier required	string The Submodel’s unique id (UTF8-BASE64-URL-encoded)

header Parameters

Edc-Bpn

string

The external subject id (bpn) indicates which tenant is allowed to see the specificAssetId and find a Shell. Using this header requires separate OAuth2 role 'AAS EDC BPN Viewer', consult the docs for more information.

Responses

Response samples

Content type

application/json

"{ \"id\": \"https://admin-shell.io/zvei/nameplate/1/0/Nameplate\", \"endpoints\": [ { \"href\": { \"href\": \"https://localhost:1234/api/v3.0/submodel\", \"endpointProtocol\": \"HTTP\", \"endpointProtocolVersion\": [\"1.1\"] }, \"interface\": \"AAS-3.0\" }, { \"protocolInformation\": { \"href\": \"opc.tcp://localhost:4840\" }, \"interface\": \"AAS-3.0\" }, { \"protocolInformation\": { \"href\": \"https://localhost:5678\", \"endpointProtocol\": \"HTTP\", \"endpointProtocolVersion\": [\"1.1\"], \"subprotocol\": \"OPC UA Basic SOAP\", \"subprotocolBody\": \"ns=2;s=MyAAS\", \"subprotocolBodyEncoding\": \"application/soap+xml\" }, \"interface\": \"AAS-3.0\" } ] }"

Updates an existing Submodel Descriptor

path Parameters

tenantId required	string <uuid> Unique identifier of the owning tenant.
aasIdentifier required	string The Asset Administration Shell’s unique id (UTF8-BASE64-URL-encoded)
submodelIdentifier required	string The Submodel’s unique id (UTF8-BASE64-URL-encoded)

Request Body schema: application/json
required

Submodel Descriptor object

required	Array of objects (Endpoint) [ 1 .. 10000 ] items unique
idShort	string [ 1 .. 128 ] characters The idShort is not unique overall. All Submodel idShort in one Shell are unique.
id required	string [ 1 .. 2000 ] characters ^([\x09\x0a\x0d\x20-\ud7ff\ue000-\ufffd]\|\ud8...
	object (Reference)
	Array of objects (Reference) <= 50 items unique
	Array of objects (LangStringTextType) <= 50 items unique
	Array of objects (LangStringNameType) <= 50 items unique

Responses

Request samples

Payload

Content type

application/json

"{ \"id\": \"https://admin-shell.io/zvei/nameplate/1/0/Nameplate\", \"endpoints\": [ { \"href\": { \"href\": \"https://localhost:1234/api/v3.0/submodel\", \"endpointProtocol\": \"HTTP\", \"endpointProtocolVersion\": [\"1.1\"] }, \"interface\": \"AAS-3.0\" }, { \"protocolInformation\": { \"href\": \"opc.tcp://localhost:4840\" }, \"interface\": \"AAS-3.0\" }, { \"protocolInformation\": { \"href\": \"https://localhost:5678\", \"endpointProtocol\": \"HTTP\", \"endpointProtocolVersion\": [\"1.1\"], \"subprotocol\": \"OPC UA Basic SOAP\", \"subprotocolBody\": \"ns=2;s=MyAAS\", \"subprotocolBodyEncoding\": \"application/soap+xml\" }, \"interface\": \"AAS-3.0\" } ] }"

Response samples

400
403
404
500
default

Content type

application/json

{"messages": [{"code": "string",
"correlationId": "string",
"messageType": "Undefined",
"text": "string",
"timestamp": "string"
}
]
}

Deletes a Submodel Descriptor, i.e. de-registers a submodel

path Parameters

tenantId required	string <uuid> Unique identifier of the owning tenant.
aasIdentifier required	string The Asset Administration Shell’s unique id (UTF8-BASE64-URL-encoded)
submodelIdentifier required	string The Submodel’s unique id (UTF8-BASE64-URL-encoded)

Responses

Response samples

400
404
500
default

Content type

application/json

{"messages": [{"code": "string",
"correlationId": "string",
"messageType": "Undefined",
"text": "string",
"timestamp": "string"
}
]
}

Shell Group

List Shell Groups with cursor pagination

By default the page size is limited to 500 items. The maximum page size is limited to 500 items.

path Parameters

tenantId

required

string <uuid>

Unique identifier of the owning tenant.

query Parameters

limit	integer >= 1 The maximum number of elements in the response array
cursor	string A server-generated identifier retrieved from pagingMetadata that specifies from which position the result listing should continue

Responses

Response samples

Content type

application/json

{"paging_metadata": {"cursor": "wJlCDLIl6KTWypN7T6vc6nWEmEYe99Hjf1XY1xmqV-M=#"
},
"result": ["{ \"id\": \"1\", \"name\": \"Basic Shell Group\",\"description\": \"This group contains all the Shells that have basic Submodels.\"  }"
]
}

Create a new Shell Group

path Parameters

tenantId

required

string <uuid>

Unique identifier of the owning tenant.

Request Body schema: application/json
required

Shell Group object

name required	string <= 128 characters Human-readable and unique name of the Asset Administration Shell Descriptor Group
description	string <= 4000 characters Detailed description of the Asset Administration Shell Descriptor Group

Responses

Request samples

Payload

Content type

application/json

"{  \"name\": \"Basic Shell Group\",\"description\": \"This group contains all the Shells that have basic Submodels.\"  }"

Response samples

Content type

application/json

"{ \"id\": \"1\", \"name\": \"Basic Shell Group\",\"description\": \"This group contains all the Shells that have basic Submodels.\"  }"

Get Shell Group ID

path Parameters

tenantId required	string <uuid> Unique identifier of the owning tenant.
groupIdentifier required	integer <int64> The Shell Group’s unique ID

Responses

Response samples

Content type

application/json

"{ \"id\": \"1\", \"name\": \"Basic Shell Group\",\"description\": \"This group contains all the Shells that have basic Submodels.\"  }"

Replace existing Shell Group

path Parameters

tenantId required	string <uuid> Unique identifier of the owning tenant.
groupIdentifier required	integer <int64> The Asset Administration Shell’s unique ID

Request Body schema: application/json
required

Shell Group object

name required	string <= 128 characters Human-readable and unique name of the Asset Administration Shell Descriptor Group
description	string <= 4000 characters Detailed description of the Asset Administration Shell Descriptor Group

Responses

Request samples

Payload

Content type

application/json

"{ \"name\": \"Basic Shell Group\",\"description\": \"This group contains all the Shells that have basic Submodels.\"  }"

Response samples

Content type

application/json

"{ \"id\": \"1\", \"name\": \"Basic Shell Group\",\"description\": \"This group contains all the Shells that have basic Submodels.\"  }"

Partially update Shell Group

Performs a partial update on a Shell Group.
The API uses the JSON Merge Patch convention see https://datatracker.ietf.org/doc/html/rfc7386.

path Parameters

tenantId required	string <uuid> Unique identifier of the owning tenant.
groupIdentifier required	integer <int64> The Asset Administration Shell’s unique ID

Request Body schema: application/json
required

Shell Group object

name	string or null <= 128 characters Human-readable and unique name of the Asset Administration Shell Descriptor Group
description	string or null <= 4000 characters Detailed description of the Asset Administration Shell Descriptor Group

Responses

Request samples

Payload

Content type

application/json

"{ \"name\": \"Basic Shell Group\",\"description\": \"This group contains all the Shells that have basic Submodels.\"  }"

Response samples

Content type

application/json

"{ \"id\": \"1\", \"name\": \"Basic Shell Group\",\"description\": \"This group contains all the Shells that have basic Submodels.\"  }"

Delete Shell Group

path Parameters

tenantId required	string <uuid> Unique identifier of the owning tenant.
groupIdentifier required	integer <int64> The Shell Group’s unique ID

Responses

Response samples

400
404
500
default

Content type

application/json

{"messages": [{"code": "string",
"correlationId": "string",
"messageType": "Undefined",
"text": "string",
"timestamp": "string"
}
]
}

Submodel Descriptor Template

Returns all Submodel Descriptor Templates

path Parameters

tenantId

required

string <uuid>

Unique identifier of the owning tenant.

query Parameters

limit	integer >= 1 The maximum number of elements in the response array
cursor	string A server-generated identifier retrieved from pagingMetadata that specifies from which position the result listing should continue

Responses

Response samples

Content type

application/json

{"paging_metadata": {"cursor": "wJlCDLIl6KTWypN7T6vc6nWEmEYe99Hjf1XY1xmqV-M=#"
},
"result": ["{\"endpointTemplates\":[{\"id\":1,\"interfaceNameTemplate\":\"sampleInterface\",\"protocolInformationTemplate\":{\"hrefTemplate\":\"https://example12345.com/path?id={shellId}\",\"endpointTemplateProtocol\":\"http\",\"endpointTemplateProtocolVersions\":[\"v1\"],\"subprotocolTemplate\":\"SOAP\",\"subprotocolBodyTemplate\":\"xml\",\"subprotocolBodyEncodingTemplate\":\"appplication-xml\",\"securityAttributeTemplates\":[{\"type\":\"NONE\",\"key\":\"key1\",\"value\":\"value1\"}]}}],\"idShort\":\"sampleIdShort\",\"id\":1,\"semanticId\":{\"type\":\"ModelReference\",\"keys\":[{\"type\":\"GlobalReference\",\"value\":\"sampleTextOfSemanticId\"}]},\"supplementalSemanticId\":[{\"type\":\"ExternalReference\",\"keys\":[{\"type\":\"GlobalReference\",\"value\":\"sampleTextOfSupplementalSemanticId\"}]}],\"groups\":[{\"id\":1}],\"description\":[{\"language\":\"en\",\"text\":\"sampleText\"},{\"language\":\"de\",\"text\":\"beispieltext\"}],\"displayName\":[{\"language\":\"en\",\"text\":\"sampleText\"},{\"language\":\"de\",\"text\":\"beispieltext\"}]}"
]
}

Creates a new Submodel Descriptor Template

path Parameters

tenantId

required

string <uuid>

Unique identifier of the owning tenant.

Request Body schema: application/json
required

Submodel Descriptor Template object

required	Array of objects (EndpointTemplateCreateDto) [ 1 .. 10000 ] items unique
idShort	string [ 1 .. 128 ] characters The idShort is not unique overall. All Submodel Descriptor Template idShort in one Shell are unique.
	object (Reference)
	Array of objects (Reference) <= 50 items unique
groups	Array of integers <int64> (EntityId) <= 50 items unique [ items <int64 > ] Shell Groups to which the Submodel Descriptor Template is assigned.
	Array of objects (LangStringTextType) <= 50 items unique
	Array of objects (LangStringNameType) <= 50 items unique

Responses

Request samples

Payload

Content type

application/json

"{\"endpointTemplates\":[{\"interfaceNameTemplate\":\"sampleInterface\",\"protocolInformationTemplate\":{\"hrefTemplate\":\"https://example12345.com/path?id={shellId}\",\"endpointTemplateProtocol\":\"http\",\"endpointTemplateProtocolVersions\":[\"v1\"],\"subprotocolTemplate\":\"SOAP\",\"subprotocolBodyTemplate\":\"xml\",\"subprotocolBodyEncodingTemplate\":\"appplication-xml\",\"securityAttributeTemplates\":[{\"type\":\"NONE\",\"key\":\"key1\",\"value\":\"value1\"}]}}],\"idShort\":\"sampleIdShort\",\"semanticId\":{\"type\":\"ModelReference\",\"keys\":[{\"type\":\"GlobalReference\",\"value\":\"sampleTextOfSemanticId\"}],\"referredSemanticId\":{\"type\":\"ExternalReference\",\"keys\":[{\"type\":\"Submodel\",\"value\":\"sampleTextParentOfSemanticId\"}]}},\"supplementalSemanticId\":[{\"type\":\"ExternalReference\",\"keys\":[{\"type\":\"GlobalReference\",\"value\":\"sampleTextOfSupplementalSemanticId\"}],\"referredSemanticId\":{\"type\":\"ExternalReference\",\"keys\":[{\"type\":\"Submodel\",\"value\":\"sampleTextParentOfSupplementalSemanticId\"}]}}],\"groups\":[1],\"description\":[{\"language\":\"en\",\"text\":\"sampleText\"},{\"language\":\"de\",\"text\":\"beispieltext\"}],\"displayName\":[{\"language\":\"en\",\"text\":\"sampleText\"},{\"language\":\"de\",\"text\":\"beispieltext\"}]}"

Response samples

Content type

application/json

"{\"endpointTemplates\":[{\"id\":1,\"interfaceNameTemplate\":\"sampleInterface\",\"protocolInformationTemplate\":{\"hrefTemplate\":\"https://example12345.com/path?id={shellId}\",\"endpointTemplateProtocol\":\"http\",\"endpointTemplateProtocolVersions\":[\"v1\"],\"subprotocolTemplate\":\"SOAP\",\"subprotocolBodyTemplate\":\"xml\",\"subprotocolBodyEncodingTemplate\":\"appplication-xml\",\"securityAttributeTemplates\":[{\"type\":\"NONE\",\"key\":\"key1\",\"value\":\"value1\"}]}}],\"idShort\":\"sampleIdShort\",\"id\":1,\"semanticId\":{\"type\":\"ModelReference\",\"keys\":[{\"type\":\"GlobalReference\",\"value\":\"sampleTextOfSemanticId\"}]},\"supplementalSemanticId\":[{\"type\":\"ExternalReference\",\"keys\":[{\"type\":\"GlobalReference\",\"value\":\"sampleTextOfSupplementalSemanticId\"}]}],\"groups\":[{\"id\":1}],\"description\":[{\"language\":\"en\",\"text\":\"sampleText\"},{\"language\":\"de\",\"text\":\"beispieltext\"}],\"displayName\":[{\"language\":\"en\",\"text\":\"sampleText\"},{\"language\":\"de\",\"text\":\"beispieltext\"}]}"

Returns a specific Submodel Descriptor Template

path Parameters

tenantId required	string <uuid> Unique identifier of the owning tenant.
templateId required	integer <int64> Example: 1234L The Submodel Descriptor Template’s unique ID

Responses

Response samples

Content type

application/json

"{\"endpointTemplates\":[{\"id\":1,\"interfaceNameTemplate\":\"sampleInterface\",\"protocolInformationTemplate\":{\"hrefTemplate\":\"https://example12345.com/path?id={shellId}\",\"endpointTemplateProtocol\":\"http\",\"endpointTemplateProtocolVersions\":[\"v1\"],\"subprotocolTemplate\":\"SOAP\",\"subprotocolBodyTemplate\":\"xml\",\"subprotocolBodyEncodingTemplate\":\"appplication-xml\",\"securityAttributeTemplates\":[{\"type\":\"NONE\",\"key\":\"key1\",\"value\":\"value1\"}]}}],\"idShort\":\"sampleIdShort\",\"id\":1,\"semanticId\":{\"type\":\"ModelReference\",\"keys\":[{\"type\":\"GlobalReference\",\"value\":\"sampleTextOfSemanticId\"}]},\"supplementalSemanticId\":[{\"type\":\"ExternalReference\",\"keys\":[{\"type\":\"GlobalReference\",\"value\":\"sampleTextOfSupplementalSemanticId\"}]}],\"groups\":[{\"id\":1}],\"description\":[{\"language\":\"en\",\"text\":\"sampleText\"},{\"language\":\"de\",\"text\":\"beispieltext\"}],\"displayName\":[{\"language\":\"en\",\"text\":\"sampleText\"},{\"language\":\"de\",\"text\":\"beispieltext\"}]}"

Updates an existing Submodel Descriptor Template

path Parameters

tenantId required	string <uuid> Unique identifier of the owning tenant.
templateId required	integer <int64> Example: 1234L The Submodel Descriptor Template’s unique ID

Request Body schema: application/json
required

Submodel Descriptor Template object

required	Array of objects (EndpointTemplateCreateDto) [ 1 .. 10000 ] items unique
idShort	string [ 1 .. 128 ] characters The idShort is not unique overall. All Submodel Descriptor Template idShort in one Shell are unique.
	object (Reference)
	Array of objects (Reference) <= 50 items unique
groups	Array of integers <int64> (EntityId) <= 50 items unique [ items <int64 > ] Shell Groups to which the Submodel Descriptor Template is assigned.
	Array of objects (LangStringTextType) <= 50 items unique
	Array of objects (LangStringNameType) <= 50 items unique

Responses

Request samples

Payload

Content type

application/json

{ }

Response samples

Content type

application/json

"{\"endpointTemplates\":[{\"id\":1,\"interfaceNameTemplate\":\"sampleInterface\",\"protocolInformationTemplate\":{\"hrefTemplate\":\"https://example12345.com/path?id={shellId}\",\"endpointTemplateProtocol\":\"http\",\"endpointTemplateProtocolVersions\":[\"v1\"],\"subprotocolTemplate\":\"SOAP\",\"subprotocolBodyTemplate\":\"xml\",\"subprotocolBodyEncodingTemplate\":\"appplication-xml\",\"securityAttributeTemplates\":[{\"type\":\"NONE\",\"key\":\"key1\",\"value\":\"value1\"}]}}],\"idShort\":\"sampleIdShort\",\"id\":1,\"semanticId\":{\"type\":\"ModelReference\",\"keys\":[{\"type\":\"GlobalReference\",\"value\":\"sampleTextOfSemanticId\"}]},\"supplementalSemanticId\":[{\"type\":\"ExternalReference\",\"keys\":[{\"type\":\"GlobalReference\",\"value\":\"sampleTextOfSupplementalSemanticId\"}]}],\"groups\":[{\"id\":1}],\"description\":[{\"language\":\"en\",\"text\":\"sampleText\"},{\"language\":\"de\",\"text\":\"beispieltext\"}],\"displayName\":[{\"language\":\"en\",\"text\":\"sampleText\"},{\"language\":\"de\",\"text\":\"beispieltext\"}]}"

Partially update an existing Submodel Descriptor Template

path Parameters

tenantId required	string <uuid> Unique identifier of the owning tenant.
templateId required	integer <int64> Example: 1234L The Submodel Descriptor Template’s unique ID

Request Body schema: application/json
required

Submodel Descriptor Template object

idShort	string or null [ 1 .. 128 ] characters The idShort is not unique overall. All Submodel Descriptor Template idShort in one Shell are unique.
	object or null (Reference)
	Array of objects or null (Reference) <= 50 items unique
	Array of objects or null (LangStringTextType) <= 50 items unique
	Array of objects or null (LangStringNameType) <= 50 items unique
groups	Array of integers or null <int64> (EntityId) <= 50 items unique Shell Groups to which the Submodel Descriptor Template is assigned.
listOperator required	string (ListOperator) Default: "replace" Enum: "replace" "add" "remove" Operator to specify the kind of operation to perform on lists given within the body. Add/Remove operations featuring null or empty values produce no effect. Add/Remove operator adds / removes a single element. Replace replaces the entire list.

Responses

Request samples

Payload

Content type

application/json

"{\"idShort\":\"newsampleIdShort\",\"semanticId\":{\"type\":\"ModelReference\",\"keys\":[{\"type\":\"GlobalReference\",\"value\":\"mergedsampleTextOfSemanticId\"}],\"referredSemanticId\":{\"type\":\"ExternalReference\",\"keys\":[{\"type\":\"Submodel\",\"value\":\"mergedsampleTextParentOfSemanticId\"}]}},\"supplementalSemanticId\":[{\"type\":\"ExternalReference\",\"keys\":[{\"type\":\"GlobalReference\",\"value\":\"mergedsampleTextOfSupplementalSemanticId\"}],\"referredSemanticId\":{\"type\":\"ExternalReference\",\"keys\":[{\"type\":\"Submodel\",\"value\":\"mergedsampleTextParentOfSupplementalSemanticId\"}]}}],\"description\":[{\"language\":\"de\",\"text\":\"verschmelzenbeispieltext\"},{\"language\":\"en\",\"text\":\"mergedsampleText\"}],\"displayName\":[{\"language\":\"de\",\"text\":\"verschmelzenbeispieltext\"},{\"language\":\"en\",\"text\":\"mergedsampleText\"}]}"

Response samples

Content type

application/json

"{\"endpointTemplates\":[{\"id\":1,\"interfaceNameTemplate\":\"sampleInterface\",\"protocolInformationTemplate\":{\"hrefTemplate\":\"https://example12345.com/path?id={shellId}\",\"endpointTemplateProtocol\":\"http\",\"endpointTemplateProtocolVersions\":[\"v1\"],\"subprotocolTemplate\":\"SOAP\",\"subprotocolBodyTemplate\":\"xml\",\"subprotocolBodyEncodingTemplate\":\"appplication-xml\",\"securityAttributeTemplates\":[{\"type\":\"NONE\",\"key\":\"key1\",\"value\":\"value1\"}]}}],\"idShort\":\"sampleIdShort\",\"id\":1,\"semanticId\":{\"type\":\"ModelReference\",\"keys\":[{\"type\":\"GlobalReference\",\"value\":\"sampleTextOfSemanticId\"}]},\"supplementalSemanticId\":[{\"type\":\"ExternalReference\",\"keys\":[{\"type\":\"GlobalReference\",\"value\":\"sampleTextOfSupplementalSemanticId\"}]}],\"groups\":[{\"id\":1}],\"description\":[{\"language\":\"en\",\"text\":\"sampleText\"},{\"language\":\"de\",\"text\":\"beispieltext\"}],\"displayName\":[{\"language\":\"en\",\"text\":\"sampleText\"},{\"language\":\"de\",\"text\":\"beispieltext\"}]}"

Deletes a Submodel Descriptor Template

path Parameters

tenantId required	string <uuid> Unique identifier of the owning tenant.
templateId required	integer <int64> Example: 1234L The Submodel Descriptor Template’s unique ID

Responses

Response samples

400
404
500
default

Content type

application/json

{"messages": [{"code": "string",
"correlationId": "string",
"messageType": "Undefined",
"text": "string",
"timestamp": "string"
}
]
}

Endpoint Template

Creates a new Endpoint Template

path Parameters

tenantId required	string <uuid> Unique identifier of the owning tenant.
templateId required	integer <int64> Example: 1234L The Submodel Descriptor Template’s unique ID

Request Body schema: application/json
required

Endpoint Template object

interfaceNameTemplate required	string [ 1 .. 128 ] characters
required	object (ProtocolInformationTemplate)

Responses

Request samples

Payload

Content type

application/json

"{\"interfaceNameTemplate\":\"interfaceNameTemplate\",\"protocolInformationTemplate\":{\"hrefTemplate\":\"https://example.com/path?id={shellId}&{specificAssetId=(<testkey1>)}\",\"endpointTemplateProtocolVersions\":[\"v1\"],\"securityAttributeTemplates\":[{\"type\":\"NONE\",\"key\":\"someKey1\",\"value\":\"someValue1\"}]}}"

Response samples

Content type

application/json

"{\"id\":2,\"interfaceNameTemplate\":\"interfaceNameTemplate\",\"protocolInformationTemplate\":{\"hrefTemplate\":\"https://example.com/path?id={shellId}&{specificAssetId=(<testkey1>)}\",\"endpointTemplateProtocolVersions\":[\"v1\"],\"securityAttributeTemplates\":[{\"type\":\"NONE\",\"key\":\"someKey1\",\"value\":\"someValue1\"}]}}"

Updates an existing Endpoint Template

path Parameters

tenantId required	string <uuid> Unique identifier of the owning tenant.
templateId required	integer <int64> Example: 1234L The Submodel Descriptor Template’s unique ID
id required	integer <int64> Example: 1234L The Endpoint Template’s unique ID

Request Body schema: application/json
required

Endpoint Template object

interfaceNameTemplate required	string [ 1 .. 128 ] characters
required	object (ProtocolInformationTemplate)

Responses

Request samples

Payload

Content type

application/json

{ }

Response samples

Content type

application/json

"{\"id\":2,\"interfaceNameTemplate\":\"interfaceNameTemplate\",\"protocolInformationTemplate\":{\"hrefTemplate\":\"https://example.com/path?id={shellId}&{specificAssetId=(<testkey1>)}\",\"endpointTemplateProtocolVersions\":[\"v1\"],\"securityAttributeTemplates\":[{\"type\":\"NONE\",\"key\":\"someKey1\",\"value\":\"someValue1\"}]}}"

Partially update an existing Endpoint Template

path Parameters

tenantId required	string <uuid> Unique identifier of the owning tenant.
templateId required	integer <int64> Example: 1234L The Submodel Descriptor Template’s unique ID
id required	integer <int64> Example: 1234L The Endpoint Template’s unique ID

Request Body schema: application/json
required

Endpoint Template object

interfaceNameTemplate	string or null [ 1 .. 128 ] characters
	object or null

Responses

Request samples

Payload

Content type

application/json

"{\"interfaceNameTemplate\":\"newInterFaceName\"}"

Response samples

Content type

application/json

"{\"id\":2,\"interfaceNameTemplate\":\"interfaceNameTemplate\",\"protocolInformationTemplate\":{\"hrefTemplate\":\"https://example.com/path?id={shellId}&{specificAssetId=(<testkey1>)}\",\"endpointTemplateProtocolVersions\":[\"v1\"],\"securityAttributeTemplates\":[{\"type\":\"NONE\",\"key\":\"someKey1\",\"value\":\"someValue1\"}]}}"

Deletes an Endpoint Template

path Parameters

tenantId required	string <uuid> Unique identifier of the owning tenant.
templateId required	integer <int64> Example: 1234L The Submodel Descriptor Template’s unique ID
id required	integer <int64> Example: 1234L The Endpoint Template’s unique ID

Responses

Response samples

400
404
500
default

Content type

application/json

{"messages": [{"code": "string",
"correlationId": "string",
"messageType": "Undefined",
"text": "string",
"timestamp": "string"
}
]
}

Asset Administration Shell Registry Service Specification Profile SSP-001 Version 3.0 (V3.0.3_SSP-001)

Asset Administration Shell Registry

Returns all Asset Administration Shell Descriptors

path Parameters

query Parameters

header Parameters

Responses

Response samples

Creates a new Asset Administration Shell Descriptor, i.e. registers an AAS

path Parameters

Request Body schema: application/jsonrequired

Responses

Request samples

Response samples

Returns a specific Asset Administration Shell Descriptor

path Parameters

header Parameters

Responses

Response samples

Updates an existing Asset Administration Shell Descriptor

path Parameters

Request Body schema: application/jsonrequired

Responses

Request samples

Response samples

Deletes an Asset Administration Shell Descriptor, i.e. de-registers an AAS

path Parameters

Responses

Response samples

Returns all Submodel Descriptors

path Parameters

query Parameters

header Parameters

Responses

Response samples

Creates a new Submodel Descriptor, i.e. registers a submodel

path Parameters

Request Body schema: application/jsonrequired

Responses

Request samples

Response samples

Returns a specific Submodel Descriptor

path Parameters

header Parameters

Responses

Response samples

Updates an existing Submodel Descriptor

path Parameters

Request Body schema: application/jsonrequired

Responses

Request samples

Response samples

Deletes a Submodel Descriptor, i.e. de-registers a submodel

path Parameters

Responses

Response samples

Shell Group

List Shell Groups with cursor pagination

path Parameters

query Parameters

Responses

Response samples

Create a new Shell Group

path Parameters

Request Body schema: application/jsonrequired

Responses

Request samples

Response samples

Get Shell Group ID

path Parameters

Responses

Response samples

Replace existing Shell Group

path Parameters

Request Body schema: application/jsonrequired

Responses

Request samples

Response samples

Partially update Shell Group

path Parameters

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required