Astrata

This page provides specific information about integrating Astrata’s devices into the Astara Connect system through our API services. This process can also be done via the Platform by following the steps for registering a tracker.

Connectivity

The vehicles can be connected via OBD or Canbus.

Register and validation process

When you register a vehicle into Astara Connect with Astrata as a data provider, the vehicle validation process is usually quick and easy.

POST /trackers/register

This is an example of the body of the request.

{
    "tracker_id"="359632104952350",
    "provider"="astrata",
    "type"="obd",
    "vehicle_type"="car",
    "object_id"={
        "vin": "WF0AXXWPMAJBXXXXX",
        "license_plate": "6666KKK",
        "make": "Hyundai",
        "model": "Civic"
    }
}

The required information is:

• tracker_id: A unique identifier of the vehicle. For the Astrata trackers, the tracker_id will be the device's IMEI number.
• provider: data provider of the vehicle: astrata
• type: indicates the type of connection at the vehicle. In most cases, there will be an OBD connection: obd

The validate endpoint could be requested when the endpoint status is pending.

POST /trackers/validate

The request body must include the same required information as in the register endpoint:

{
    "tracker_id"="359632104952350",
    "provider"="astrata",
    "type"="obd"
}

Then, upon receiving the first location data from the tracker, the validation status will be updated to connected.

To ingest the first location data, the tracker/vehicle must drive outdoors approximately 500m to send the first coordinates, which will be ingested in Astara Connect.

Connectivity states for an Astrata tracker

These are the possible states of the tracker with Astrata connection into Astara Connect, and it will be available through the Platform and the API services:

• pending: default state once the register endpoint is completed.
• wrong_tracker_id : The IMEI ID is incorrect. Check the IMEI number and modify it if necessary. Then, launch the register request again with the right IMEI number.
• pending_for_data: We are waiting for the first coordinates from the provider. If the vehicle is in motion and the status has not changed, check the device connection or contact the data provider.
• error_data: no data is received, or telemetry data is incorrect.
• connected: a final state to indicate that we are ingesting data from the data provider into Astara Connect.

⚠️ Astrata does not guarantee access via OBD to the data because it may be variable depending on the make and model.

If, during the validation process, the vehicle status is error_data from the data provider, an alternative to obtain valuable data is the connection via hardware with our partner Targa.

You can learn more about the Connectivity states

For any questions, please get in touch with us at [email protected]