This public release contains the definition and documentation of
- location-verification v3.0.0
- location-retrieval v0.5.0
- geofencing-subscriptions v0.5.0
The API definition(s) are based on
- Commonalities r3.3
- Identity and Consent Management r3.3
location-verification v3.0.0
location-verification v3.0.0 is the public release for the next stable version of the API Location Verification.
There is breaking change compared to the previous release r2.2, due to the deprecation of UNKNOWN value for verificationResult in favor of the new error 422 LOCATION_VERIFICATION.UNABLE_TO_LOCATE.
-
API definition with inline documentation:
Added
- New error code
422 LOCATION_VERIFICATION.UNABLE_TO_LOCATE. - New
DeviceResponseobject in responses limited to one identifier. - Clarifications on non-documented error responses.
Changed
- Updated string pattern for
x-correlatorheaders. - Type of
radiusfor CIRCLE Area changed fromintegertonumber, and maximum removed. - Clarified format for properties with format
date-time.
Removed
verificationResult: UNKNOWNfor 200 responses.- Error
422 IDENTIFIER_MISMATCH. - Error
401 AUTHENTICATION_REQUIRED.
location-retrieval v0.5.0
location-retrieval v0.5.0 is the public release for the next initial version of the API Location Retrieval. It introduces breaking changes compared to the previous release r2.2, due to the deprecation of error 404 LOCATION_RETRIEVAL.DEVICE_NOT_FOUND in favor of the new error 422 LOCATION_RETRIEVAL.UNABLE_TO_LOCATE.
-
API definition with inline documentation:
Added
- New error
422 LOCATION_RETRIEVAL.UNABLE_TO_LOCATE. - New
DeviceResponseobject in responses limited to one identifier. - Clarifications on non-documented error responses.
Changed
- Updated string pattern for
x-correlatorheaders. - Clarified format for properties with format
date-time.
Removed
- Error
404 LOCATION_RETRIEVAL.DEVICE_NOT_FOUND. - Error
422 IDENTIFIER_MISMATCH. - Error
401 AUTHENTICATION_REQUIRED.
geofencing-subscriptions v0.5.0
geofencing-subscriptions v0.5.0 is the public release for the next initial version of the API Geofencing Subscriptions. It introduces breaking changes compared to the previous release r2.2, coming from the alignment to the new guidelines in Commonalities for APIs with subscriptions.
-
API definition with inline documentation:
Added
- New subscription event types for
subscription-startedandsubscription-updated. - New
DeviceResponseobject in responses and events, limited to one identifier. - Pattern to property
sinkand new error400 INVALID_SINK. - Clarifications on non-documented error responses.
Changed
- Subscription event type
subscription-endsrenamed tosubscription-ended. - Property
idbecomes required forSubscriptionAsyncobjects. - operationId
createSubscriptionrenamed tocreateGeofencingSubscription. - Updated string pattern for
x-correlatorheaders. - Type of
radiusfor CIRCLE Area changed fromintegertonumber, and maximum removed. - Clarified format for properties with format
date-time.
Fixed
- Subscription types array items must be limited to allowed
SubscriptionEventTypevalues
Removed
- Error
422 IDENTIFIER_MISMATCH. - Error
401 AUTHENTICATION_REQUIRED.