New SRM API Endpoint - Update Telematics

How third-party telematics providers can send data to SRM using SRM’s new /update/telematics endpoint.

In This Article

• Introduction
• /update/telematics Endpoint
• Endpoint Availability

Introduction

Texada offers a number of APIs that allow third parties to retrieve data from and send data to Texada SRM. For more information, see “Texada SRM APIs”. 

With this update, a new SRM API endpoint has been added that allows telematics providers to update machine information via API.

/update/telematics Endpoint

View Swagger documentation for this endpoint

Pictured above, the new /update/telematics endpoint gives Texada customers and their telematics providers the ability to update machine telematics information via API. If you use telematics equipment to track your machines, this endpoint will make it much easier to send up-to-date information to Texada SRM.

This endpoint includes the following variables:

• type: The request’s type. Accepts one of three possible values:
  • P (product): SRM Product update.
  • S (asset tag): Asset tag update.
  • T (telematics): Telematics update.
• typeID: The ID of the object to be updated. Accepts a different type of value depending on the request’s type:
  • P: SRM Product number. Please note that this endpoint does not work with bulk Products.
  • S: Asset tag serial number.
  • T: Telematics ID (end user responsible for populating the telematic ID during inventory clean up)
• currentMeter: The Product’s current meter reading. Must be higher than the existing meter. If this value is lower than the existing meter, no change will be made.
• latitude: The Product’s Latitude.
• longitude: The Product’s Longitude.
• date: UTC date. Will be adjusted to local date. YYYYMMDD format.
• time: UTC time. Will be adjusted to local time. HHMMSS format.
• vendor: Telematics vendor. 3 characters; information only.

Endpoint Availability

To enable this integration, a new entry must be added to the Maintain Web Services API Keys utility in Texada SRM, located at System Maintenance → Configure System Settings → Security → Web Service API Keys.

To receive your API key, please contact Texada at partners@texadasoftware.com.