Including two different versions of NGSI-LD OAS release 1.6.1: one for OpenAPI version 3.0.3 and one for OpenAPI version 3.1.0. The OpenAPI version 3.0.3 is recommended to be used by third-party development tools as most of them do not support version 3.1.0 yet. The OpenAPI version 3.1.0 is recommended for reviewing the NGSI-LD OAS documentation and operations. The ReDoc visualization application has been chosen as the solution to navigate the NGSI-LD OAS documentation.

Deleting the schema SystemGeneratedAttributes for grouping schemas of system-generated temporal attributes (i.e., createdAt, modifiedAt, and deletedAt) and updating the references to them directly. The problem is that if the schemas of the system-generated temporal attributes are grouped under a schema SystemGeneratedAttributes their data appears with the SystemGeneratedAttributes wrapper when is referenced by another schema or operation.

Fixing minor issue regarding indentation within the definition of Query.options.noOverwrite parameter.

Removing the content for json+ld and geo MIME types of the global responses relative to errors within the NGSI-LD OAS.

Including NGSILD-Warning Header for all GET operations and for all type of HTTP responses, also for HTTP 20X responses. Adding NGSILD-Warning for the global responses of NGSI-LD OAS BadRequest, NotFound, and Unprocessable.

Deleting the required statements for timerel and timeAt query parameters of 5.7.4 Query Temporal Evolution of Entities, and indicating  within the description of the operation that requirements.

Removing the allOf wrapper for schemas definition when they reference to other schemas that include additional sibling descriptions, because the original schema (i.e., the reference one) is lost.

For schemas definitions with  to other schemas that include additional sibling descriptions, wrapping the  into allOf.

Fixing issues with headers definition within the operation responses on NGSI-LD OAS. Including all the possible headers within the global response defined on responses section of NGSI-LD OAS.

Updating example of custom OpenAPI schemas that are compliant with the NGSI-LD OAS for IoT sensors use case.

Removing allOf keyword for references to additional components when there are already descriptions. Including  and description fields together despite the sibling issue in OAS 3.0.3.

NGSI-LD Data Types (Schemas, Headers, and Parameters) - OAS 1.6.1

Recovering SubscriptionFragment Request Body definition. Generating a new Path common schema for URI data type in path parameters. Generating a new SystemGeneratedAttributes for grouping subschemas of system-generated temporal attributes: createdAt, modifiedAt, and deletedAt, and updating references to it. Keeping NGSILD-Warning header only for HTTP GET operations performed over the resources /entities and /entities/{entity-id}.

Reviewing and fixing issues regarding schemas, headers and parameters sections within the NGSI-LD OAS 1.6.1.

NGSI-LD Context Source Registration and Context Source Discovery Operations - OAS 1.6.1

NGSI-LD Context Information Subscription and Context Source Registration Subscription Operations - OAS 1.6.1

NGSI-LD Context Information Provision Operations - OAS 1.6.1

NGSI-LD Context Information Consumption Operations - OAS 1.6.1

NGSI-LD JSON-LD Context Operations - OAS 1.6.1

NGSI-LD Batch Operations - OAS 1.6.1

Show the @context field on top of the request and response/request bodies for the Registry API operations for Temporal Context Information Provision operations.

Show the @context field on top of the request and response/request bodies for the Registry API operations for Temporal Context Information Consumption operations.

Adding the default value of 0 for aggrPeriodDuration query parameter as mandated from 5.7.4 Query Temporal Evolution of Entities and 5.7.3 Retrieve Temporal Evolution of an Entity operations.