Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

End point:

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

...

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

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

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

Параметр

Приклад

Опис

auth_token

{ ваш токен авторизації }

POST/GET параметр або Bearer Authentication

api_type

reports

тип запиту

api_name

geozones-SE

метод, який викликаємо

data

data=[{"deviceID":"11111","geozones":[{"geozoneID":555,"start":1689593662}]},{"deviceID":"22222","geozones":[{"geozoneID":666,"start":1689593662},{"geozoneID":777,"start":1689593662}]}]

дані для завантаження звіту

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

Code Block
languagejson
{
    "result": "ok",
    "response": {
        "11111": {
            "geozones": [
                {
                    "geozoneID": 555,
                    "in": 1694848118,
                    "out": 1694849633
                }
            ]
        },
        "22222": {
            "geozones": [
                {
                    "geozoneID": 666,
                    "in": null,
                    "out": 1700518262
                },
                {
                    "geozoneID": 777,
                    "in": null,
                    "out": null
                }
            ]
        }
    }
}

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

Параметр

Опис

11111, 22222, 33333

ID пристрою

geozones

список геозон, які перевірялись

geozoneID

ID геозони, яка перевірялась

in

час в'їзду у форматі timestamp (UTC), цей час може бути менший за той, який ми передали у запиті (якщо авто уже стояло в даній геозоні), може бути null, якщо авто ні разу не в'їжджало геозону

out

час виїзду у форматі timestamp (UTC), може бути null, якщо авто ні разу не виїжджало геозону

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

Code Block
{
    "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 пристрою у відповіді

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

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

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

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

Wrong Timestamp

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

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

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

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

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

...