Polte Quick Start Guide

Developers: Have your own tracking application, or want to use capabilities not available with us yet? Easily integrate the Polte Location API with third party platforms and enterprise systems using our Polte Quick Start Guide.

Home » Developers » Polte Quick Start Guide

1. Claim the Device

1A. Request an Account

  • You should already have a Polte IoT Cloud (PIC) account to use this Quick Start Guide. If you don’t, you can contact us to request an account here.
  • Once complete, log in to the PIC at https://polte.io./.

1B. Initiate Bulk Claim

  • Next, to claim your device IMEI (UE): Click on the User Equipment menu → Bulk Claim.
  • Enter IMEI (s) in a CSV file and upload.
  • Click on the “Submit” button.
  • Now, if the device you own is a button, turn it ON.
  • The device connects to the Polte IoT Cloud.
  • Navigate to User Equipment → UE Map View to see the location of your device.

1C. Directions for Third-Party Integrators

If you are a third-party integrator with Polte, read on…​

To consume Polte APIs, you have to authenticate with login credentials and the Polte server issues a Bearer token that you use for authorization when you make REST API calls.

POST /users/login

curl -X POST https://polte.io/api/v1/users/login
-H "accept: application/json"
-H "Content-Type: application/json"
-d "{ "email":\"abc@polte.com", "password":\"xxxxxxxx"}"

Authorization: Bearer <Access-token>

  • You can claim your device as mentioned in the steps above OR you can claim your device with the REST API call.
POST /customer/{customerId}/userEquipment/claim

curl -X POST https://polte.io/api/v1/customer/<customer_id>/userEquipment/claim \
-H "accept: application/json" \
-H "Authorization: Bearer xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d "{ "imeis": [ "" ]}"

2. Register the Device

2A. Create API Token

  • To register your device, the MCU triggers the AT+POLTEREG? command to the chipset.
  • The chipset sends back the registration tokens which are in turn sent to the integrator’s cloud.
  • To register your device using the Polte API, create an API token.
  • Go to https://polte.io/swagger/customer/
  • Call the API to create an API token.
POST /customer/{customerId}/apiTokens

curl -X POST https://polte.io/api/v1/customer/<customer_id>/apiTokens \
-H "accept: application/json" \
-H "Authorization: Bearer xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d "{ "role": "UE"}”

2B. Copy the API Token

Call the register API, GET /ue/register/

curl -X GET https://polte.io/api/v1/ue/register?manufacturerToken=
<manufacturer_token>&modelToken=<model_token>&ueToken=<ue_token>&imei=<imei> \
-H "accept: application/json" \
-H "Authorization: Polte-API API-Token"
  • The Polte server will return the MQTT tokens (mqttAuthUser:mqttAuthPassword) which are needed for interacting with the
 locate APIs.

3. Locate the Device

3A. Create X-UE-Auth String

  • To get the location of the device, payload data is sent over AT+POLTECOMPRESS command.
  • Create X-UE-Auth string which is base64 encoding of mqtt tokens (mqttAuthUser:mqttAuthPassword).

3B. Request Location

  • Request API call to return the location (lat/long).
POST /ue/{ueToken}/locate

curl -X POST https://polte.io/api/v1/ue/<ue_token>>/locate?sync=true \
-H "accept: application/json" \
-H "X-UE-Auth: base64 encoded mqttAuthUser:mqttAuthPassword" \
-H "Authorization: Polte-API API-Token" \
-H "Content-Type: application/json" \
-d "{ "payload": \”payload from device"}"
  • View the location on the Mapping interface on the PIC.

Polte provides you with Swagger, an interactive tool to test drive the Polte Location API.

Polte Quick Start Guide

 

Have questions using our Polte Quick Start Guide? Help is only a click away. Reach out to our Support team here.

Polte’s breakthrough location technologies, coupled with Fleetilla’s nearly two decades expertise in design and deployment of long-life, wide area outdoor location solutions, will allow us to now offer seamless end-to-end supply chain and equipment visibility – indoors and outdoors.

Visit our Documentation Request page to gain access to the Polte Location API.