Fuel SE

End point:

https://gps.freetrack.com.ua/api/

Опис

Список доступних методів

fuel-SE- вибираємо перше входження пристроїв в множину геозон

Приклади використання

_{*червоні параметри є обов'язковими}

Параметр	Приклад	Опис

Параметр	Приклад	Опис
auth_token	{ ваш токен авторизації }	POST/GET параметр або Bearer Authentication
api_type	reports	тип запиту
api_name	fuel-SE	метод, який викликаємо
data	data=[{ "deviceID":`7777`, "checkGeozones":false, "timeIntervals":["1704146400,1704232799","1702300820,1702329989","1702329989,1702330944"]}, {"deviceID":`8888`,"timeIntervals":["1704146400,1704232799","1702300820,1702329989","1702329989,1702330944"]}]	дані для завантаження звіту… deviceID - ід пристрою, checkGeozones - по замовчуванню = false, не обов'язковий параметр, який каже чи потрібно перевіряти входження в геозони… timeIntervals - часові інтервали для обраного пристрою.

Приклад правильної відповіді

{
    "result": "ok",
    "response": {
        "7777": {
            "intersectionData": [],
            "intervals": [
                {
                    "dateFrom": 1704146400,
                    "dateTo": 1704232799,
                    "result": {
                        "durationOfMoving": 4687,
                        "durationOfStop": 2405,
                        "distance": 47.89,
                        "averageSpeed": 31.48421052631579,
                        "consumption": 0,
                        "consumptionKm": 0,
                        "consumptionInMotion": 0,
                        "zones": {
                            "8756": "База ЦЗ"
                        },
                        "distanceForSpeed": {
                            "speedDiapasones": {
                                "10": {
                                    "distance": 3.73,
                                    "duration": 1968
                                },
                                "20": {
                                    "distance": 11.91,
                                    "duration": 2557
                                },
                                "30": {
                                    "distance": 12.79,
                                    "duration": 1714
                                },
                                "40": {
                                    "distance": 14.52,
                                    "duration": 1523
                                },
                                "50": {
                                    "distance": 21.64,
                                    "duration": 1989
                                },
                                "60": {
                                    "distance": 27.62,
                                    "duration": 1883
                                },
                                "70": {
                                    "distance": 32.34,
                                    "duration": 1928
                                },
                                "80": {
                                    "distance": 45.81,
                                    "duration": 2228
                                },
                                "90": {
                                    "distance": 53.51,
                                    "duration": 2291
                                },
                                "100": {
                                    "distance": 76.22,
                                    "duration": 2902
                                },
                                "over_100": {
                                    "distance": 32.72,
                                    "duration": 1165
                                }
                            },
                            "speedDiapasonesDistance": 332.81,
                            "speedDiapasonesDuration": 22148,
                            "speedDiapasonesDinstanceMax": 76.2235459236999,
                            "speedDiapasonesDurationMax": 2902
                        }
                    }
                }   
            ]
        }
    }
}

Опис відповіді

Параметр	Опис

Параметр	Опис
11111, 22222, 33333	ID пристрою
geozones	список геозон, які перевірялись
geozoneID	ID геозони, яка перевірялась
in	час в'їзду у форматі timestamp (UTC), цей час може бути менший за той, який ми передали у запиті (якщо авто уже стояло в даній геозоні), може бути null, якщо авто ні разу не в'їжджало геозону
out	час виїзду у форматі timestamp (UTC), може бути null, якщо авто ні разу не виїжджало геозону

Приклад неправильної відповіді

{
    "result": "ok",
    "response": {
        "11111": {
            "geozones": [
                {
                    "geozoneID": -1,
                    "errorMessage": "Can`t find ['geozoneID'] at the item list"
                },
                {
                    "geozoneID": 555,
                    "errorMessage": "Wrong Timestamp"
                },
                {
                    "geozoneID": 666,
                    "errorMessage": "Can`t find ['start'] at the item list"
                }
            ]
        },
        "33333": {
            "errorMessage": "User has not permission on the object with ID [134]"
        },
        "22222": {
            "errorMessage": "Can`t find ['geozones'] at the item list"
        },
        "-1": {
            "errorMessage": "Can`t find ['deviceID'] at the item list"
        }
    }
}

Типи можливих помилок

Помилка	Пояснення

Помилка	Пояснення
Can`t parse the parameter - [data]	не перeданий параметр [data]
Can`t find ['deviceID'] at the item list	не перeданий ключ [deviceID], “-1” замість ID пристрою у відповіді
User has not permission on the object with ID [33333]	нема доступу до об'єкту з ID [33333]
Can`t find ['geozones'] at the item list	не переданий ключ [geozones]
Can`t find ['geozoneID'] at the item list	не перeданий ключ [geozoneID]
Can`t find ['start'] at the item list	не переданий ключ [start]
Wrong Timestamp	неправильний формат дати: дата має бути у форматі timestamp (UTC), не раніше, ніж поточний рік і не пізніше 2000 року

НАВЧАЛЬНИЙ ПОСІБНИК

Fuel SE

Опис

Список доступних методів

Приклади використання

Приклад правильної відповіді

Опис відповіді

Приклад неправильної відповіді

Типи можливих помилок

Can`t parse the parameter - [data]

не перeданий параметр [data]

Can`t find ['deviceID'] at the item list

не перeданий ключ [deviceID], “-1” замість ID пристрою у відповіді

User has not permission on the object with ID [33333]

нема доступу до об'єкту з ID [33333]

Can`t find ['geozones'] at the item list

не переданий ключ [geozones]

Can`t find ['geozoneID'] at the item list

не перeданий ключ [geozoneID]

Can`t find ['start'] at the item list

не переданий ключ [start]

Wrong Timestamp

неправильний формат дати: дата має бути у форматі timestamp (UTC), не раніше, ніж поточний рік і не пізніше 2000 року