Loading ngsi-ld-api.yaml +65 −34 Original line number Original line Diff line number Diff line Loading @@ -3187,8 +3187,9 @@ components: content: content: application/json: application/json: schema: schema: $ref: '#/components/schemas/EntityTemporal' allOf: required: - $ref: '#/components/schemas/EntityTemporal' - required: - id - id - type - type application/json+ld: application/json+ld: Loading Loading @@ -3492,7 +3493,8 @@ components: error: error: description: | description: | One instance per Entity in error. One instance per Entity in error. $ref: '#/components/schemas/ProblemDetails' allOf: - $ref: '#/components/schemas/ProblemDetails' required: required: - entityId - entityId - error - error Loading Loading @@ -3630,7 +3632,8 @@ components: Entity information as specified by the observedAt Temporal Property. Entity information as specified by the observedAt Temporal Property. A temporal query based on the observedAt Temporal Property, which is the default, A temporal query based on the observedAt Temporal Property, which is the default, is matched against the observationInterval for overlap. is matched against the observationInterval for overlap. $ref: '#/components/schemas/TimeInterval' allOf: - $ref: '#/components/schemas/TimeInterval' managementInterval: managementInterval: description: | description: | If present, the Context Source can be queried for Temporal Entity Representations. (If latest Entity If present, the Context Source can be queried for Temporal Entity Representations. (If latest Entity Loading @@ -3639,23 +3642,27 @@ components: information as specified by the createdAt, modifiedAt and deletedAt Temporal Properties. information as specified by the createdAt, modifiedAt and deletedAt Temporal Properties. A temporal query based on the createdAt, modifiedAt or deletedAt Temporal Property is matched A temporal query based on the createdAt, modifiedAt or deletedAt Temporal Property is matched against the managementInterval for overlap. against the managementInterval for overlap. $ref: '#/components/schemas/TimeInterval' allOf: - $ref: '#/components/schemas/TimeInterval' location: location: description: | description: | Location for which the Context Source may be able to provide information. Location for which the Context Source may be able to provide information. $ref: '#/components/schemas/Geometry' allOf: - $ref: '#/components/schemas/Geometry' observationSpace: observationSpace: description: | description: | Geographic location that includes the observation spaces of all entities as specified by their Geographic location that includes the observation spaces of all entities as specified by their respective observationSpace GeoProperty for which the Context Source may be able to provide respective observationSpace GeoProperty for which the Context Source may be able to provide information. information. $ref: '#/components/schemas/Geometry' allOf: - $ref: '#/components/schemas/Geometry' operationSpace: operationSpace: description: | description: | Geographic location that includes the operation spaces of all entities as specified by their Geographic location that includes the operation spaces of all entities as specified by their respective operationSpace GeoProperty for which the Context Source may be able to provide respective operationSpace GeoProperty for which the Context Source may be able to provide information. information. $ref: '#/components/schemas/Geometry' allOf: - $ref: '#/components/schemas/Geometry' expiresAt: expiresAt: description: | description: | Provides an expiration date. When passed the Context Source Registration Provides an expiration date. When passed the Context Source Registration Loading Loading @@ -3710,7 +3717,8 @@ components: description: | description: | Holds additional optional registration management information that can be used Holds additional optional registration management information that can be used to limit unnecessary distributed operation requests. to limit unnecessary distributed operation requests. $ref: '#/components/schemas/RegistrationManagementInfo' allOf: - $ref: '#/components/schemas/RegistrationManagementInfo' # Clause 5.2.2 Common members. System-generated temporal attributes. # Clause 5.2.2 Common members. System-generated temporal attributes. systemGeneratedAttrs: systemGeneratedAttrs: allOf: allOf: Loading Loading @@ -3843,15 +3851,18 @@ components: location: location: description: | description: | Default geospatial Property of an entity. See clause 4.7. Default geospatial Property of an entity. See clause 4.7. $ref: '#/components/schemas/GeoProperty' allOf: - $ref: '#/components/schemas/GeoProperty' observationSpace: observationSpace: description: | description: | See clause 4.7. See clause 4.7. $ref: '#/components/schemas/GeoProperty' allOf: - $ref: '#/components/schemas/GeoProperty' operationSpace: operationSpace: description: | description: | See clause 4.7. See clause 4.7. $ref: '#/components/schemas/GeoProperty' allOf: - $ref: '#/components/schemas/GeoProperty' # Clause 5.2.2 Common members. System-generated temporal attributes. # Clause 5.2.2 Common members. System-generated temporal attributes. systemGeneratedAttrs: systemGeneratedAttrs: allOf: allOf: Loading Loading @@ -3959,15 +3970,18 @@ components: location: location: description: | description: | Default geospatial Property of an entity. See clause 4.7. Default geospatial Property of an entity. See clause 4.7. $ref: '#/components/schemas/GeoProperty' allOf: - $ref: '#/components/schemas/GeoProperty' observationSpace: observationSpace: description: | description: | See clause 4.7. See clause 4.7. $ref: '#/components/schemas/GeoProperty' allOf: - $ref: '#/components/schemas/GeoProperty' operationSpace: operationSpace: description: | description: | See clause 4.7. See clause 4.7. $ref: '#/components/schemas/GeoProperty' allOf: - $ref: '#/components/schemas/GeoProperty' # Clause 5.2.2 Common members. System-generated temporal attributes. # Clause 5.2.2 Common members. System-generated temporal attributes. systemGeneratedAttrs: systemGeneratedAttrs: allOf: allOf: Loading Loading @@ -4104,16 +4118,19 @@ components: geometry: geometry: description: | description: | Null if no matching GeoProperty. Null if no matching GeoProperty. $ref: '#/components/schemas/Geometry' allOf: - $ref: '#/components/schemas/Geometry' properties: properties: description: | description: | List of attributes as mandated by clause 5.2.31. List of attributes as mandated by clause 5.2.31. $ref: '#/components/schemas/FeatureProperties' allOf: - $ref: '#/components/schemas/FeatureProperties' '@context': '@context': description: | description: | JSON-LD @context. This field is only present if requested in the payload by JSON-LD @context. This field is only present if requested in the payload by the HTTP Prefer Header (IETF RFC 7240). the HTTP Prefer Header (IETF RFC 7240). $ref: '#/components/schemas/LdContext' allOf: - $ref: '#/components/schemas/LdContext' required: required: - id - id - type - type Loading Loading @@ -4141,7 +4158,8 @@ components: description: | description: | JSON-LD @context. This field is only present if requested in the payload JSON-LD @context. This field is only present if requested in the payload by the HTTP Prefer Header (IETF RFC 7240). by the HTTP Prefer Header (IETF RFC 7240). $ref: '#/components/schemas/LdContext' allOf: - $ref: '#/components/schemas/LdContext' required: required: - type - type FeatureProperties: FeatureProperties: Loading Loading @@ -4301,11 +4319,13 @@ components: value: value: description: | description: | Geolocation encoded as GeoJSON. As mandated by clause 4.7. Geolocation encoded as GeoJSON. As mandated by clause 4.7. $ref: '#/components/schemas/Geometry' allOf: - $ref: '#/components/schemas/Geometry' observedAt: observedAt: description: | description: | Timestamp. See clause 4.8. Timestamp. See clause 4.8. $ref: '#/components/schemas/ObservedAt' allOf: - $ref: '#/components/schemas/ObservedAt' datasetId: datasetId: description: | description: | It allows identifying a set or group of property values. It allows identifying a set or group of property values. Loading @@ -4326,7 +4346,8 @@ components: description: | description: | Previous GeoProperty value. Only used in notifications, if the showChanges Previous GeoProperty value. Only used in notifications, if the showChanges option is explicitly requested. option is explicitly requested. $ref: '#/components/schemas/Geometry' allOf: - $ref: '#/components/schemas/Geometry' readOnly: true readOnly: true additionalProperties: additionalProperties: oneOf: oneOf: Loading Loading @@ -4406,7 +4427,8 @@ components: observedAt: observedAt: description: | description: | Timestamp. See clause 4.8. Timestamp. See clause 4.8. $ref: '#/components/schemas/ObservedAt' allOf: - $ref: '#/components/schemas/ObservedAt' datasetId: datasetId: description: | description: | It allows identifying a set or group of property values. It allows identifying a set or group of property values. Loading Loading @@ -4602,7 +4624,8 @@ components: endpoint: endpoint: description: | description: | Notification endpoint details. Notification endpoint details. $ref: '#/components/schemas/Endpoint' allOf: - $ref: '#/components/schemas/Endpoint' status: status: description: | description: | Status of the Notification. It shall be "ok" if the last attempt to notify the subscriber succeeded. Status of the Notification. It shall be "ok" if the last attempt to notify the subscriber succeeded. Loading Loading @@ -4731,7 +4754,8 @@ components: observedAt: observedAt: description: | description: | Timestamp. See clause 4.8. Timestamp. See clause 4.8. $ref: '#/components/schemas/ObservedAt' allOf: - $ref: '#/components/schemas/ObservedAt' unitCode: unitCode: description: | description: | Property Value's unit code. Property Value's unit code. Loading Loading @@ -4805,7 +4829,8 @@ components: geoQ: geoQ: description: | description: | Geoquery that shall be matched by Entities in order be retrieved. Geoquery that shall be matched by Entities in order be retrieved. $ref: '#/components/schemas/GeoQuery' allOf: - $ref: '#/components/schemas/GeoQuery' csf: csf: description: | description: | Context source filter that shall be matched by Context Source Registrations describing Context source filter that shall be matched by Context Source Registrations describing Loading Loading @@ -4834,7 +4859,8 @@ components: temporalQ: temporalQ: description: | description: | Temporal Query to be present only for "Query Temporal Evolution of Entities" operation (clause 5.7.4). Temporal Query to be present only for "Query Temporal Evolution of Entities" operation (clause 5.7.4). $ref: '#/components/schemas/TemporalQuery' allOf: - $ref: '#/components/schemas/TemporalQuery' - required: - required: - temporalQ - temporalQ RegistrationInfo: RegistrationInfo: Loading Loading @@ -4914,7 +4940,8 @@ components: observedAt: observedAt: description: | description: | Timestamp. See clause 4.8. Timestamp. See clause 4.8. $ref: '#/components/schemas/ObservedAt' allOf: - $ref: '#/components/schemas/ObservedAt' datasetId: datasetId: description: | description: | It allows identifying a set or group of target relationship objects. It allows identifying a set or group of target relationship objects. Loading Loading @@ -5005,7 +5032,8 @@ components: geoQ: geoQ: description: | description: | Geoquery that shall be met by subscribed entities in order to trigger the notification. Geoquery that shall be met by subscribed entities in order to trigger the notification. $ref: '#/components/schemas/GeoQuery' allOf: - $ref: '#/components/schemas/GeoQuery' csf: csf: description: | description: | Context source filter that shall be met by Context Source Registrations describing Context Sources Context source filter that shall be met by Context Source Registrations describing Context Sources Loading @@ -5021,7 +5049,8 @@ components: notification: notification: description: | description: | Notification details. Notification details. $ref: '#/components/schemas/NotificationParams' allOf: - $ref: '#/components/schemas/NotificationParams' expiresAt: expiresAt: description: | description: | Expiration date for the subscription. Expiration date for the subscription. Loading @@ -5031,7 +5060,8 @@ components: description: | description: | Temporal Query to be used only in Context Registration Subscriptions for matching Temporal Query to be used only in Context Registration Subscriptions for matching Context Source Registrations of Context Sources providing temporal information. Context Source Registrations of Context Sources providing temporal information. $ref: '#/components/schemas/TemporalQuery' allOf: - $ref: '#/components/schemas/TemporalQuery' scopeQ: scopeQ: description: | description: | Scope query. Scope query. Loading Loading @@ -5197,7 +5227,8 @@ components: observedAt: observedAt: description: | description: | Timestamp. See clause 4.8. Timestamp. See clause 4.8. $ref: '#/components/schemas/ObservedAt' allOf: - $ref: '#/components/schemas/ObservedAt' datasetId: datasetId: description: | description: | It allows identifying a set or group of property values. It allows identifying a set or group of property values. Loading Loading
ngsi-ld-api.yaml +65 −34 Original line number Original line Diff line number Diff line Loading @@ -3187,8 +3187,9 @@ components: content: content: application/json: application/json: schema: schema: $ref: '#/components/schemas/EntityTemporal' allOf: required: - $ref: '#/components/schemas/EntityTemporal' - required: - id - id - type - type application/json+ld: application/json+ld: Loading Loading @@ -3492,7 +3493,8 @@ components: error: error: description: | description: | One instance per Entity in error. One instance per Entity in error. $ref: '#/components/schemas/ProblemDetails' allOf: - $ref: '#/components/schemas/ProblemDetails' required: required: - entityId - entityId - error - error Loading Loading @@ -3630,7 +3632,8 @@ components: Entity information as specified by the observedAt Temporal Property. Entity information as specified by the observedAt Temporal Property. A temporal query based on the observedAt Temporal Property, which is the default, A temporal query based on the observedAt Temporal Property, which is the default, is matched against the observationInterval for overlap. is matched against the observationInterval for overlap. $ref: '#/components/schemas/TimeInterval' allOf: - $ref: '#/components/schemas/TimeInterval' managementInterval: managementInterval: description: | description: | If present, the Context Source can be queried for Temporal Entity Representations. (If latest Entity If present, the Context Source can be queried for Temporal Entity Representations. (If latest Entity Loading @@ -3639,23 +3642,27 @@ components: information as specified by the createdAt, modifiedAt and deletedAt Temporal Properties. information as specified by the createdAt, modifiedAt and deletedAt Temporal Properties. A temporal query based on the createdAt, modifiedAt or deletedAt Temporal Property is matched A temporal query based on the createdAt, modifiedAt or deletedAt Temporal Property is matched against the managementInterval for overlap. against the managementInterval for overlap. $ref: '#/components/schemas/TimeInterval' allOf: - $ref: '#/components/schemas/TimeInterval' location: location: description: | description: | Location for which the Context Source may be able to provide information. Location for which the Context Source may be able to provide information. $ref: '#/components/schemas/Geometry' allOf: - $ref: '#/components/schemas/Geometry' observationSpace: observationSpace: description: | description: | Geographic location that includes the observation spaces of all entities as specified by their Geographic location that includes the observation spaces of all entities as specified by their respective observationSpace GeoProperty for which the Context Source may be able to provide respective observationSpace GeoProperty for which the Context Source may be able to provide information. information. $ref: '#/components/schemas/Geometry' allOf: - $ref: '#/components/schemas/Geometry' operationSpace: operationSpace: description: | description: | Geographic location that includes the operation spaces of all entities as specified by their Geographic location that includes the operation spaces of all entities as specified by their respective operationSpace GeoProperty for which the Context Source may be able to provide respective operationSpace GeoProperty for which the Context Source may be able to provide information. information. $ref: '#/components/schemas/Geometry' allOf: - $ref: '#/components/schemas/Geometry' expiresAt: expiresAt: description: | description: | Provides an expiration date. When passed the Context Source Registration Provides an expiration date. When passed the Context Source Registration Loading Loading @@ -3710,7 +3717,8 @@ components: description: | description: | Holds additional optional registration management information that can be used Holds additional optional registration management information that can be used to limit unnecessary distributed operation requests. to limit unnecessary distributed operation requests. $ref: '#/components/schemas/RegistrationManagementInfo' allOf: - $ref: '#/components/schemas/RegistrationManagementInfo' # Clause 5.2.2 Common members. System-generated temporal attributes. # Clause 5.2.2 Common members. System-generated temporal attributes. systemGeneratedAttrs: systemGeneratedAttrs: allOf: allOf: Loading Loading @@ -3843,15 +3851,18 @@ components: location: location: description: | description: | Default geospatial Property of an entity. See clause 4.7. Default geospatial Property of an entity. See clause 4.7. $ref: '#/components/schemas/GeoProperty' allOf: - $ref: '#/components/schemas/GeoProperty' observationSpace: observationSpace: description: | description: | See clause 4.7. See clause 4.7. $ref: '#/components/schemas/GeoProperty' allOf: - $ref: '#/components/schemas/GeoProperty' operationSpace: operationSpace: description: | description: | See clause 4.7. See clause 4.7. $ref: '#/components/schemas/GeoProperty' allOf: - $ref: '#/components/schemas/GeoProperty' # Clause 5.2.2 Common members. System-generated temporal attributes. # Clause 5.2.2 Common members. System-generated temporal attributes. systemGeneratedAttrs: systemGeneratedAttrs: allOf: allOf: Loading Loading @@ -3959,15 +3970,18 @@ components: location: location: description: | description: | Default geospatial Property of an entity. See clause 4.7. Default geospatial Property of an entity. See clause 4.7. $ref: '#/components/schemas/GeoProperty' allOf: - $ref: '#/components/schemas/GeoProperty' observationSpace: observationSpace: description: | description: | See clause 4.7. See clause 4.7. $ref: '#/components/schemas/GeoProperty' allOf: - $ref: '#/components/schemas/GeoProperty' operationSpace: operationSpace: description: | description: | See clause 4.7. See clause 4.7. $ref: '#/components/schemas/GeoProperty' allOf: - $ref: '#/components/schemas/GeoProperty' # Clause 5.2.2 Common members. System-generated temporal attributes. # Clause 5.2.2 Common members. System-generated temporal attributes. systemGeneratedAttrs: systemGeneratedAttrs: allOf: allOf: Loading Loading @@ -4104,16 +4118,19 @@ components: geometry: geometry: description: | description: | Null if no matching GeoProperty. Null if no matching GeoProperty. $ref: '#/components/schemas/Geometry' allOf: - $ref: '#/components/schemas/Geometry' properties: properties: description: | description: | List of attributes as mandated by clause 5.2.31. List of attributes as mandated by clause 5.2.31. $ref: '#/components/schemas/FeatureProperties' allOf: - $ref: '#/components/schemas/FeatureProperties' '@context': '@context': description: | description: | JSON-LD @context. This field is only present if requested in the payload by JSON-LD @context. This field is only present if requested in the payload by the HTTP Prefer Header (IETF RFC 7240). the HTTP Prefer Header (IETF RFC 7240). $ref: '#/components/schemas/LdContext' allOf: - $ref: '#/components/schemas/LdContext' required: required: - id - id - type - type Loading Loading @@ -4141,7 +4158,8 @@ components: description: | description: | JSON-LD @context. This field is only present if requested in the payload JSON-LD @context. This field is only present if requested in the payload by the HTTP Prefer Header (IETF RFC 7240). by the HTTP Prefer Header (IETF RFC 7240). $ref: '#/components/schemas/LdContext' allOf: - $ref: '#/components/schemas/LdContext' required: required: - type - type FeatureProperties: FeatureProperties: Loading Loading @@ -4301,11 +4319,13 @@ components: value: value: description: | description: | Geolocation encoded as GeoJSON. As mandated by clause 4.7. Geolocation encoded as GeoJSON. As mandated by clause 4.7. $ref: '#/components/schemas/Geometry' allOf: - $ref: '#/components/schemas/Geometry' observedAt: observedAt: description: | description: | Timestamp. See clause 4.8. Timestamp. See clause 4.8. $ref: '#/components/schemas/ObservedAt' allOf: - $ref: '#/components/schemas/ObservedAt' datasetId: datasetId: description: | description: | It allows identifying a set or group of property values. It allows identifying a set or group of property values. Loading @@ -4326,7 +4346,8 @@ components: description: | description: | Previous GeoProperty value. Only used in notifications, if the showChanges Previous GeoProperty value. Only used in notifications, if the showChanges option is explicitly requested. option is explicitly requested. $ref: '#/components/schemas/Geometry' allOf: - $ref: '#/components/schemas/Geometry' readOnly: true readOnly: true additionalProperties: additionalProperties: oneOf: oneOf: Loading Loading @@ -4406,7 +4427,8 @@ components: observedAt: observedAt: description: | description: | Timestamp. See clause 4.8. Timestamp. See clause 4.8. $ref: '#/components/schemas/ObservedAt' allOf: - $ref: '#/components/schemas/ObservedAt' datasetId: datasetId: description: | description: | It allows identifying a set or group of property values. It allows identifying a set or group of property values. Loading Loading @@ -4602,7 +4624,8 @@ components: endpoint: endpoint: description: | description: | Notification endpoint details. Notification endpoint details. $ref: '#/components/schemas/Endpoint' allOf: - $ref: '#/components/schemas/Endpoint' status: status: description: | description: | Status of the Notification. It shall be "ok" if the last attempt to notify the subscriber succeeded. Status of the Notification. It shall be "ok" if the last attempt to notify the subscriber succeeded. Loading Loading @@ -4731,7 +4754,8 @@ components: observedAt: observedAt: description: | description: | Timestamp. See clause 4.8. Timestamp. See clause 4.8. $ref: '#/components/schemas/ObservedAt' allOf: - $ref: '#/components/schemas/ObservedAt' unitCode: unitCode: description: | description: | Property Value's unit code. Property Value's unit code. Loading Loading @@ -4805,7 +4829,8 @@ components: geoQ: geoQ: description: | description: | Geoquery that shall be matched by Entities in order be retrieved. Geoquery that shall be matched by Entities in order be retrieved. $ref: '#/components/schemas/GeoQuery' allOf: - $ref: '#/components/schemas/GeoQuery' csf: csf: description: | description: | Context source filter that shall be matched by Context Source Registrations describing Context source filter that shall be matched by Context Source Registrations describing Loading Loading @@ -4834,7 +4859,8 @@ components: temporalQ: temporalQ: description: | description: | Temporal Query to be present only for "Query Temporal Evolution of Entities" operation (clause 5.7.4). Temporal Query to be present only for "Query Temporal Evolution of Entities" operation (clause 5.7.4). $ref: '#/components/schemas/TemporalQuery' allOf: - $ref: '#/components/schemas/TemporalQuery' - required: - required: - temporalQ - temporalQ RegistrationInfo: RegistrationInfo: Loading Loading @@ -4914,7 +4940,8 @@ components: observedAt: observedAt: description: | description: | Timestamp. See clause 4.8. Timestamp. See clause 4.8. $ref: '#/components/schemas/ObservedAt' allOf: - $ref: '#/components/schemas/ObservedAt' datasetId: datasetId: description: | description: | It allows identifying a set or group of target relationship objects. It allows identifying a set or group of target relationship objects. Loading Loading @@ -5005,7 +5032,8 @@ components: geoQ: geoQ: description: | description: | Geoquery that shall be met by subscribed entities in order to trigger the notification. Geoquery that shall be met by subscribed entities in order to trigger the notification. $ref: '#/components/schemas/GeoQuery' allOf: - $ref: '#/components/schemas/GeoQuery' csf: csf: description: | description: | Context source filter that shall be met by Context Source Registrations describing Context Sources Context source filter that shall be met by Context Source Registrations describing Context Sources Loading @@ -5021,7 +5049,8 @@ components: notification: notification: description: | description: | Notification details. Notification details. $ref: '#/components/schemas/NotificationParams' allOf: - $ref: '#/components/schemas/NotificationParams' expiresAt: expiresAt: description: | description: | Expiration date for the subscription. Expiration date for the subscription. Loading @@ -5031,7 +5060,8 @@ components: description: | description: | Temporal Query to be used only in Context Registration Subscriptions for matching Temporal Query to be used only in Context Registration Subscriptions for matching Context Source Registrations of Context Sources providing temporal information. Context Source Registrations of Context Sources providing temporal information. $ref: '#/components/schemas/TemporalQuery' allOf: - $ref: '#/components/schemas/TemporalQuery' scopeQ: scopeQ: description: | description: | Scope query. Scope query. Loading Loading @@ -5197,7 +5227,8 @@ components: observedAt: observedAt: description: | description: | Timestamp. See clause 4.8. Timestamp. See clause 4.8. $ref: '#/components/schemas/ObservedAt' allOf: - $ref: '#/components/schemas/ObservedAt' datasetId: datasetId: description: | description: | It allows identifying a set or group of property values. It allows identifying a set or group of property values. Loading