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

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

Публичная API-страница объясняет, как мы даём scoped access к marketplace, execution, monitoring и mobile workflows. Технические детали и защищённые payload остаются в developer portal после входа.

Что обещает public contour

Core flows

Marketplace и order execution

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

Security

Scoped access вместо массового зеркалирования

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

Release

Единый release contour

API changes проходят через тот же verification, launch и mobile runtime contour, что и пользовательские интерфейсы TruckHub.

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

Scoped access означает понятные contract surface, а не абстрактное обещание “у нас тоже есть API”.

Auth и session boundary

Сессии, refresh/logout, роли и deny-by-default правила для protected surface и mobile API.

Открыть developer portal

Operational commands

Команды на access requests, loads, dispatch, orders timeline и tracking checkpoints без расхождения с UI-контуром.

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

Monitoring и release readiness

Protected payload для monitoring, verification, environments и launch, чтобы интеграция жила в общем operational contour.

Проверить system payload

Mobile handoff

TruckHub Client и Driver используют тот же API-контур, но с role-specific surface, timeout recovery и continuity rules.

Открыть mobile contour

Onboarding интеграции

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

Шаг 1

Согласовать сценарий: marketplace, execution, monitoring или mobile handoff.

Шаг 2

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

Шаг 3

Пройти verification и release contour вместе с web и mobile контрактами.

Шаг 4

Запускать production доступ только через единый launch и support/legal handoff.