General API (v1.0)
Base address:
https://api.parktrack.live
17 ноября документация Cameras, Parking Zones была обновлена, все изменения выделены жёлтым цветом.
Swagger версия
Документация API также доступна в Swagger. Там можно будет поиграться с API и вручную поотправлять запросы, когда API сервер будет готов.
Открыть документацию в Swagger
Swagger может содержать неточности или ошибки, приоритетной считать документацию на этом сайте.
Общие ошибки
| Код | Тип | Описание |
|---|---|---|
| 400 | Bad Request | Невалидный JSON или неверные типы полей. |
| 401 | Unauthorized | Отсутствует или просрочен токен. Укажи Authorization: Bearer <token>. |
| 403 | Forbidden | У пользователя нет прав создавать камеры. Проверь роли/права API-токена. |
| 415 | Unsupported Media Type | Неверный Content-Type. Используй application/json. |
| 500 | Internal Server Error | Необработанная ошибка сервера. Повтори позже; при повторе — обратись в поддержку. |
| 503 | Service Unavailable | Сервис временно недоступен/перезапускается. Повтори запрос позднее. |
Более подробное описание ошибки возвращается в JSON в ключе error_description, например:
{ "error_description": "Unsupported Media Type: expected application/json" }
Формат данных
Время
Время передается в UTC в строковом представлении в формате ISO 8601, с постфиксом Z.
Например, 2025-10-08T09:12:00Z.
Опорные точки
Для упрощения рендеринга парковочных зон, порядок выбора 4 опорных точек записывается Labeler при разметке. Пользователю должно показываться сообщение, что отмечать точки нужно по часовой стрелке. Сохраненный порядок точек должен сохраняться при передаче данных, а также при хранении на сервере.