FOTA WEB Getting Started API: Difference between revisions

Latest revision as of 10:30, 2 April 2025

Main Page > Software & Applications > FOTA WEB > FOTA WEB Getting Started API

API introduction

The FOTA WEB API allows you to integrate system functions into your own application. If you already have a user account in FOTA WEB, you automatically have access to the API! What can you do with the API? You can implement any feature available in our WEB UI, and even more, into your own application. For example, if you have fleet management software and want to create configuration updates, you can! If you need to set firmware updates, you can also do that!

Getting Started API

How to start using FOTA WEB API. You will find all of the API documentation at

https://api.teltonika.lt/documents/

To be able to use API you will need to have token

Token will be key for your access. It can be created over FOTA WEB UI https://fota.teltonika.lt

Creating API token

Step 1. To create token Login to https://fota.teltonika.lt

Step 2. Go to the top right corner and find API Tokens in the Settings.

Step 3. Next, click the Add Token button.

Step 4. Choose Token type>>API integration token, write Token name, and press Generate button.

Step 5. After the token is generated, copy it by clicking the copy button or by manually selecting and copying it.

Important! After you close the window you will not be able to check Token again. For security, the Token is not saved to the system. If you lose your token or delete an existing one, you will have to create a new one.

FOTA Web API changelog

Here is information on the latest changes to the FOTA Web API

2024-06-28

Endpoint to select several IMEI's was added. Request example: GET /devices?imei=123,123,123,123,123,....&per_page=100&page=23

2024-03-01

Message field is being moved from task attributes to separate field. Message from attributes will be removed on 2024-03-01.

2023-10-19

Datetime format inside device export files was unified to yyyy-MM-dd HH:mm:ss.

2023-09-07

Separate endpoint for bulk tasks cancellation was added. Endpoint: /tasks/bulkCancel.

2023-08-16

Separate endpoint for retry failed tasks in a task group was added. Endpoint: /batches/{batchId}/retryFailedTasks.

2023-06-30

Removed company statistics from GET /companies/<ID> response:

`device_count`
`user_count`
`file_count`
`group_count`
`task_count`
`company_count`

This data can still be accessed via dedicated endpoint GET /companies/stats?company_id=<ID>

2023-04-05

Removed device properties:

`status_id`
`status_name`

These properties are replaced by `activity_status` and `task_queue` that were introduced on 2022-12-20.

2022-12-20

Added new device properties:

`activity_status`
`task_queue`

Account Settings - Previous page

Next page - FOTA Company levels

@@ Line 3: / Line 3: @@
 =='''API introduction'''==
-FOTA WEB API allows use of system functions in your own application. If you have user in FOTA WEB then you already have API access!
+The FOTA WEB API allows you to integrate system functions into your own application. If you already have a user account in FOTA WEB, you automatically have access to the API! What can you do with the API? You can implement any feature available in our WEB UI, and even more, into your own application. For example, if you have fleet management software and want to create configuration updates, you can! If you need to set firmware updates, you can also do that!
-What can I do with the API? You can implement any feature and even more from what is available in our WEB UI into your own. If you have your fleet management software and want to create configuration update from it, you can! If want to set firmware updates, you can!
 =='''Getting Started API'''==
-How to start using FOTA WEB API. You will find all of the API documentation at https://api.teltonika.lt/documents/
+=== How to start using FOTA WEB API. You will find all of the API documentation at ===
+'''https://api.teltonika.lt/documents/'''
+=== To be able to use API you will need to have token===
+Token will be key for your access. It can be created over FOTA WEB UI '''https://fota.teltonika.lt'''
-To be able to use API you will need to have token. Token will be key for your access. It can be created over FOTA WEB UI https://fm.teltonika.lt
 =='''Creating API token'''==
-'''Step 1.''' To create token Login to https://fm.teltonika.lt
+'''Step 1.''' To create token Login to '''https://fota.teltonika.lt'''
+'''Step 2.''' Go to the top right corner and find '''API Tokens''' in the '''Settings'''.
+[[Image:FOTA WEB settings 5.png|300px|center]]'''Step 3.''' Next, click the '''Add Token''' button.[[File:API tokens1.png|thumb|center]]
+'''Step 4.''' Choose '''Token type>>API integration token''', write '''Token name''', and press '''Generate''' button.
+[[Image:Generate API tokens.png|300px|center]]
+'''Step 5.''' After the token is generated, copy it by clicking the copy button or by manually selecting and copying it.
+[[Image:Generated API token.png|[[File:Generated API token.png|thumb]]550|center]]
+'''Important!''' After you close the window you will not be able to check Token again. For security, the Token is not saved to the system. If you lose your token or delete an existing one, you will have to create a new one.
+=='''FOTA Web API changelog'''==
+Here is information on the latest changes to the FOTA Web API
+===2024-06-28===
+Endpoint to select several IMEI's was added. Request example: GET /devices?imei=123,123,123,123,123,....&per_page=100&page=23
+===2024-03-01===
+Message field is being moved from task attributes to separate field. Message from attributes will be removed on 2024-03-01.
+===2023-10-19===
+Datetime format inside device export files was unified to yyyy-MM-dd HH:mm:ss.
+===2023-09-07===
+Separate endpoint for bulk tasks cancellation was added. Endpoint: /tasks/bulkCancel.
+===2023-08-16===
+Separate endpoint for retry failed tasks in a task group was added. Endpoint: /batches/{batchId}/retryFailedTasks.
+===2023-06-30===
+Removed company statistics from GET /companies/<ID> response:
+* `device_count`
+* `user_count`
+* `file_count`
+* `group_count`
+* `task_count`
+* `company_count`
+This data can still be accessed via dedicated endpoint GET /companies/stats?company_id=<ID>
+===2023-04-05===
+Removed device properties:
+* `status_id`
+* `status_name`
+These properties are replaced by `activity_status` and `task_queue` that were introduced on 2022-12-20.
+===2022-12-20===
+Added new device properties:
+* `activity_status`
+* `task_queue`
-'''Step 2.''' Go to settings at top right corner and find API Tokens settings.
+{|style="width:100%;"
-[[Image:Settings_API.png|300px|center]]
+|-
-'''Step 3.''' Write name for the Token (1) and press Create (2).
+|[https://wiki.teltonika-gps.com/view/Account_Settings'''Account Settings'''] - Previous page
-[[Image:API_tokens.png|550px|center]]
+|style="text-align:right;| Next page - [https://wiki.teltonika-gps.com/view/Company_levels '''FOTA Company levels''']
-'''Step 4.''' Press on the Token to copy or select it and copy manually.
+|}
-[[Image:API_tokens_2.png|550|center]]
-'''Important!''' After you close the window you will not be able to check Token again. For security Token is not saved to the system. If you lose your token or delete existing one, you will have to create new one.
+[[Category:FOTA WEB]]