TruckHub API и интеграции

Интеграции TruckHub должны усиливать продуктовый контур, а не дублировать его отдельным каналом.

Публичная API-страница объясняет, как мы даём доступ по роли к бирже, исполнению заказов, мониторингу и мобильным сценариям. Технические детали и защищённые данные остаются в разделе интеграций после входа.

Что обещает публичный контур

Основные потоки

Биржа и исполнение заказа

Потоки публикации грузов, короткого списка, диспетчеризации, таймлайна и статусы рейса должны читаться одинаково в вебе, API и мобильном контуре.

Безопасность

Доступ по роли вместо массового зеркалирования

Интеграции получают договорной доступ к нужным контрактным разделам, а не неограниченный экспорт всей биржи или данных доверия.

Релиз

Единый релизный контур

Изменения API проходят через те же проверки, запуск и мобильный рабочий контур, что и пользовательские интерфейсы TruckHub.

Контур контрактов

Доступ по роли означает понятные контрактные разделы, а не абстрактное обещание “у нас тоже есть API”.

Авторизация и граница сессии

Сессии, обновление, выход, роли и правила deny-by-default для защищённых разделов и мобильного API.

Открыть раздел интеграций

Операционные команды

Команды на заявки доступа, грузы, диспетчеризацию, таймлайн заказов и контрольные точки трекинга без расхождения с UI-контуром.

Смотреть контракты

Мониторинг и готовность релиза

Защищённые данные для мониторинга, проверок, окружений и запуска нужны, чтобы интеграция жила в общем операционном контуре.

Проверить системные данные

Передача в мобильный контур

TruckHub Client и Driver используют тот же API-контур, но с разделением по ролям, восстановлением после таймаута и правилами непрерывности.

Открыть мобильный контур

Onboarding интеграции

Новый API-доступ должен проходить через тот же операционный порядок, что и запуск реального клиента.

Шаг 1

Согласовать сценарий: биржа, исполнение заказа, мониторинг или передача в мобильный контур.

Шаг 2

Определить роли, компании и область данных вместо широкого общего доступа.

Шаг 3

Пройти проверки и релизный контур вместе с веб- и мобильными контрактами.

Шаг 4

Запускать боевой доступ только через единый запуск и передачу в поддержку или правовой канал.