Skip to content

Releases: admin-shell-io/aas-specs-api

AAS API Definitions V3.0.3

15 Oct 14:56
c4e3eab
Compare
Choose a tag to compare

This bugfix release contains the OpenAPI files released by the Industrial Digital Twin Association (IDTA) and the Plattform Industrie 4.0 defining the different Asset Administration Shell APIs. It contains the descriptions in the form of machine-readable YAML documents according to the OpenAPI v3.0.3 specification. The normative reference is the publication "Specification of the Asset Administration Shell: Part 2", in particular, the version 3.0.3 (V3.0.3). It can be downloaded from the Industrial Digital Twin Association (IDTA) Content Hub and found in the files below.

What's Changed

  • Reintroducing the design decision for the ReferenceParent class due to resolvement problems reappearing in SwaggerHub
  • Adding the missing GetSubmodelElementsMetadataResult class to the OpenAPI definitions for the AAS API classes

Full Commit Changelog: v3.0.2...v3.0.3

AAS API Definitions V3.0.2

03 Jul 15:58
Compare
Choose a tag to compare

This bugfix release contains the OpenAPI files released by the Industrial Digital Twin Association (IDTA) and the Plattform Industrie 4.0 defining the different Asset Administration Shell APIs. It contains the descriptions in the form of machine-readable YAML documents according top the OpenAPI v3.0.3 specification. The normative reference is the publication "Specification of the Asset Administration Shell: Part 2", in particular, the version 3.0.2 (V3.0.2). It can be downloaded from the Industrial Digital Twin Association (IDTA) Content Hub and found in the files below.

What's Changed

  • fix metadata and path endpoints
  • remove bytes
  • remove "submodelElements" from SubmodelValue
  • Replace Service Description Profiles Enum with an open List (#230)
  • change servicedescription/profiles enum to an open list, providing predefined values only as examples
  • Remove Level from /$metadata (#250)
  • remove the Level modifier from $metadata requests
  • remove allOf SubmodelElementAttributes from SubmodelElementMetadata
  • fix ValueOnly description
  • PathItem Fix (#262)
  • add array where missing + new pathitem regex
  • fix the regex pattern for part 2 classes according to the JSON schema regex (#256)
  • fix bugs in the valueonly classes
  • change annotations from array to value only
  • replace regex patterns with latest json schema v3.0.1 content
  • using the new string regex pattern also for part 2 classes

Full Commit Changelog: v3.0.1...v3.0.2

AAS API Definitions V3.0.1

21 Jun 14:52
Compare
Choose a tag to compare

This bugfix release contains the OpenAPI files released by the Industrial Digital Twin Association (IDTA) and the Plattform Industrie 4.0 defining the different Asset Administration Shell APIs. It contains the descriptions in the form of machine-readable YAML documents according top the OpenAPI v3.0.3 specification. The normative reference is the publication "Specification of the Asset Administration Shell: Part 2", in particular, the version 3.0.1 (V3.0.1). It can be downloaded from the Industrial Digital Twin Association (IDTA) Content Hub and found in the files below.

What's Changed

  • GetAllAssetAdministrationShellIdsByAssetLink: Pagination data added to the response object in the OpenAPI files.
  • GetAllSubmodelElements-ValueOnly, GetAllSubmodelElements-Metadata, GetAllSubmodelElements-Reference, GetAllSubmodelElements-Path: Removed the array around the PagedResult object in the response in the OpenAPI files.
  • DeleteAssetAdministrationShell: Removed this API Operation from the AssetAdministrationShellServiceSpecification and Entire-API-Collection OpenAPI files.
  • Changed references in SwaggerHub links from https://api.swaggerhub.com/domains/.../V3.0#/... to https://api.swaggerhub.com/domains/.../V3.0.1#/...
  • Changed SwaggerHub links from https://app.swaggerhub.com/.../V3.0_... to https://app.swaggerhub.com/.../V3.0.1_...
  • Added "type: object" declaration to the class Reference in the Part1-MetaModel-Schemas domain
  • Added the pagination metadata object to the AASX File Server Service Specification
  • Corrected the entries of the ServiceSpecificationProfileEnum
  • Remove allOf HasExtensions from Descriptor
  • Remove Level Modifier from PutSubmodelById, PutSubmodelById, and PutSubmodelElementByPath
  • Remove Serialisation Modifiers from POST API Operations
  • Remove pagination from GetSubmodelElementByPath
  • Remove Level Modifier from GetSubmodelByIdReference and GetSubmodelByIdReference
  • Moved DeleteSubmodelById to the right endpoint
  • Corrected examples for endpoints in Descriptor objects
  • Added Location header to responses of POST requests

Full Commit Changelog: v3.0...v3.0.1

AAS API Definitions V3.0

06 Jun 09:28
Compare
Choose a tag to compare

This first major release contains the OpenAPI files released by the Industrial Digital Twin Association (IDTA) and the Plattform Industrie 4.0 defining the different Asset Administration Shell APIs. It contains the descriptions in the form of machine-readable YAML documents according top the OpenAPI v3.0.3 specification. The normative reference is the publication "Specification of the Asset Administration Shell: Part 2", in particular, the version 3.0 (V3.0). It can be downloaded from the Industrial Digital Twin Association (IDTA) Content Hub and in the files below.

What's Changed

  • Introducing service specifications and profiles
  • Introducing pagination

Full Commit Changelog: v1.0RC03...v3.0

AAS API Definitions V1.0RC03

06 Jun 09:28
a8febde
Compare
Choose a tag to compare
Pre-release

This pre-release contains the OpenAPI files released by the Industrial Digital Twin Association (IDTA) and the Plattform Industrie 4.0 defining the different Asset Administration Shell APIs. It contains the descriptions in the form of machine-readable YAML documents according top the OpenAPI v3.0.3 specification. The normative reference is the publication "Specification of the Asset Administration Shell: Part 2", in particular, the release candidate 03 (V1.0RC03). It can be downloaded from the Plattform Industrie 4.0 Download Portal.