Skip to Content

История изменений

2026-07-27

Обновление портала разработчиков

  • Портал стал многоязычным: материалы публикуются по отдельным маршрутам (/tr, /en, /ru).
  • Элементы интерфейса, справочник API и контракты ответов переведены на выбранный язык.
  • Включен поиск по документации (Pagefind) с отдельным индексом для каждого языка.
  • Редизайн с упором на читаемость: улучшены контрастность, структура карточек, форма интерактивного тестирования и темная тема.
  • Задокументирован контракт PATCH (частичное обновление) для локаций, перевозчиков, получателей, шаблонов оповещений и шаблонов отправок; API уже поддерживал эти операции.
  • Для каждой операции API добавлен постоянный идентификатор ссылки (#endpoint-id).

2026-07-25

Расширенный клиентский API

  • Добавлены контракты CRUD для локаций, перевозчиков, получателей, шаблонов оповещений и шаблонов отправок.
  • Добавлены эндпоинты для статуса устройств, настроек клиента, тревог, телеметрии и истории обслуживания.
  • Добавлены контракты для создания, завершения, передачи доступа и отслеживания отправок.
  • Добавлены контракты для отчетов, пользователей, ролей и безопасных приглашений пользователей.
  • Добавлена надежная защита идемпотентности для операций POST, создающих записи.
  • Разделены модели аутентификации Public API и официального мобильного приложения.

Разделение руководств и справочника API

  • Концептуальные руководства собраны в разделе «Документация».
  • Точные контракты и примеры кода перенесены в «Справочник API».
  • Внедрена модель безопасности на основе client credentials, одночасовых токенов доступа, областей видимости (scopes) и списков разрешенных аккаунтов (allow-list).
  • Контракт Public API v1 для клиентов опубликован по адресу /api/public/v1.
  • Открыта интерактивная панель тестирования запросов в реальном времени.

2026-07-24

Первый клиентский релиз портала разработчиков

  • Добавлены руководства по интеграции мобильных и веб-приложений.
  • Сгруппированы ресурсы устройств, телеметрии, тревог, отправок и аккаунтов.
  • Задокументированы права ролей и изоляция тенантов.
  • Добавлены руководства по пагинации, ошибкам и безопасности вебхуков.

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

Путь в URL API содержит мажорную версию:

/api/public/v1

Добавление нового поля считается обратно совместимым изменением. Удаление поля, переименование поля или нарушение существующего поведения требуют выпуска новой мажорной версии.