Including two different versions of NGSI-LD OAS release 1.7.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 the description of externalDocs section of NGSI-LD OAS for describing the name of the ETSI GS CIM 009 document.

Fixing minor issues: 1) removing allOf wrapper from previousValue property of the Property schema; 2) removing allOf wrapper from value property of GeoProperty schema; and 3) Considering the VocabularyProperty schema for additionalProperties within Entity schema and for AttributeFragment request body.

Adding a clarification within the detail property description of the ProblemDetails schema about the InvalidRequest HTTP error (6.3.20 Invalid parameters).

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, NotImplemented, 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.

Adding the optional query parameter type for the selection of Entity type in additional operations as indicated in ETSI GS CIM 009 V1.7.1 (i.e., 6.5.3.1 GET /entities/{entityId}, 6.5.3.2 DELETE /entities/{entityId}, 6.5.3.3 PUT /entities/{entityId}, 6.5.3.4 PATCH /entities/{entityId}, 6.6.3.1 POST /entities/{entityId}/attrs/, 6.6.3.2 PATCH /entities/{entityId}/attrs/, 6.7.3.1 PATCH /entities/{entityId}/attrs/{attrId}, 6.7.3.2 DELETE /entities/{entityId}/attrs/{attrId}, and 6.7.3.3 PUT /entities/{entityId}/attrs/{attrId}). Adding the optional query parameter options for the selection of noOverwrite value for 6.6.3.1 POST /entities/{entityId}/attrs/ operation as indicated in ETSI GS CIM 009 V1.7.1.

Adding the HTTP 501 NotImplemented response as stated by clause 6.3.7 Representation of Entities of ETSI GS CIM 009 V1.7.1. Including the NotImplemente response for the following operations: GET /entities and GET /entities/{entityId}.

Adding the jsonldContext parameter in Subscription.Common schema as stated by clause 5.2.12 Subscription of ETSI GS CIM 009 V1.7.1.

Adding the previousValue parameter in GeoProperty schemas as stated by clause 5.2.7 GeoProperty of ETSI GS CIM 009 V1.7.1.

Adding a new schema named VocabularyProperty for the new data type considered in the clause 5.2.35 VocabularyProperty of ETSI GS CIM 009 V1.7.1.

Adding the count query parameter and NGSILD-Results-Count HTTP header for 200 response within GET /temporal/entities operation as stated by clause 6.3.13 Counting Number of Results in ETSI GS CIM 009 V1.7.1.

Updating info and externalDocs sections of the NGSI-LD OAS to indicate the version 1.7.1 of NGSI-LD API.

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