OS1 Services
Motion Tracking System
MTS API Migration Guide
12min
This guide helps you migrate from the Motion Tracking Service APIs to be deprecated by the end of March to the current API versions. Migration will ensure the apps continue to work seamlessly when older APIs are deprecated.
- Identify usage: Audit your usage to locate all places you call the deprecated MTS APIs. This is crucial to know what needs to change.
- Take note of differences: Review the API documentation to understand the key differences in requests/responses between the old and new API version.
- Update endpoints: Update the endpoints your application calls to use the new APIs.
- Modify payloads: Based on the documentation, modify request/response payloads to align with the new API spec.
- Test thoroughly: Be sure to test end-to-end to detect any issues early. Verify that expected data is still returned.
Sunset Date
Older APIs will be deprecated by end of March 2024.
New
Old
- PUT /mts/track/{trackName}/traces
- GET /mts/track/{trackName}/traces
- PUT /mts/track/{trackId}/traces
- GET /mts/track/{trackId}/traces
New
Old
- GET /mts/track/{trackName}/missing-sequence
- GET /mts/track/{trackId}/missing-sequence
New
Old
- GET /mts/track/{trackName}/snapped-distance
- GET /mts/track/{trackId}/snapped-distance
New
Old
- POST /mts/geofences/
- PUT /mts/geofences/{geofenceId}
- DELETE /mts/geofences/{geofenceId}
- GET /mts/geofences/{geofenceId}
- PUT /mts/geofences/{geofenceId}/devices
- GET /mts/geofences/{geofenceId}/devices
- GET /mts/geofences/{geofenceId}/devices/{deviceId}
- PUT /mts/geofences/{geofenceId}/devices/{deviceId}/unsubscribe
New
Old
- POST /mts/pubsub/devices/{deviceId}/subscription
- GET /mts/pubsub/devices/{deviceId}/subscription/{subscriptionId}
- PUT /mts/pubsub/devices/{deviceId}/subscription/{subscriptionId}/deactivate
The following APIs have been categorized by SIM, GPS, and mobile phones. The previous APIs will be deprecated by the end of March.
To be deprecated in March 2024
- POST /mts/providers/tracks
- GET /mts/providers/tracks
- GET /mts/providers/tracks/{externalRefId}
- GET /mts/providers/tracks/{trackId}
- PUT /mts/providers/tracks/{trackId}
- PUT /mts/providers/tracks/{externalRefId}
Developers need to migrate to these new APIs.
SIM
Smart Phones
GPS
- POST /mts/sim/tracks
- GET /mts/sim/tracks
- GET /mts/sim/tracks/{trackId}
- PUT /mts/sim/tracks/{trackId}
- GET /mts/sim/tracks/{trackName}
- PUT /mts/sim/tracks/{trackName}
Updated 29 Feb 2024
Did this page help you?