Запуск одним кліком у деталях

Огляд

Запуск одним кліком є другим із чотирьох варіантів партнерської інтеграції, і саме з нього починає більшість партнерів. Розділи нижче описують, що бачать ваші кінцеві користувачі, що отримуєте ви як бізнес і як запуск усуває тертя. Розділ Технічні деталі нижче містить інженерну специфікацію.

Що бачать ваші користувачі

Під час запуску одним кліком Launch Pad виступає як застосунок-компаньйон вашого продукту. Він відкривається в новому вікні браузера або в iframe усередині вашого інтерфейсу, усе налаштування виконується у фоні, і користувач може одразу братися до роботи.

Що отримуєте ви як партнер

Створено для бізнесу та інженерних команд, які хочуть вбудовувати точну маршрутизацію, не будуючи інфраструктуру для її підтримки.

Місце запуску одним кліком серед варіантів

Verge пропонує чотири способи додати Launch Pad у ваш продукт, у порядку зростання зусиль. Запуск одним кліком другий із них, і саме з нього починає більшість партнерів. Порівняйте всі чотири варіанти.

1. Варіант 1
   White Label

   Без коду. Ваш логотип, піддомен і білінг поверх Launch Pad як є.

2. Ви тут

   Варіант 2

   Запуск одним кліком

   Кілька викликів API. Редактор маршрутів Launch Pad виконує планування, а план повертається вам.

3. Варіант 3
   API-інтеграція

   Ваш інтерфейс, наш рушій. Ви самі відображаєте й передаєте план.

4. Варіант 4
   Enterprise

   Спільний проєкт. Launch Pad нативно вбудований у вашу FMIS.

Як запуск одним кліком усуває тертя

Навіщо потрібен запуск одним кліком

Модель облікового запису

Взаємодія в межах запуску одним кліком організована так:

Що користувачі бачать у Launch Pad

Коли користувач відкриває Launch Pad через партнерський запуск, деякі опції Launch Pad не застосовуються і приховані:

• Немає зміни пароля, керування email або обліковим записом, немає реєстрації. У користувача немає пароля Launch Pad; вхід здійснюється через ваш продукт. На екрані зміни пароля відображається повідомлення «Пароль управляється [Партнером]» — так само, як Launch Pad вже обробляє користувачів, що входять через John Deere, Trimble або CNH.
• Немає перемикача компанії. Сесія прив'язана до єдиної організації клієнта на час візиту.
• Вихід замінено на «Повернутись до [Партнера]», що закриває вкладку або відправляє користувача назад на вказаний вами URL, замість того щоб залишати його на сторінці входу Launch Pad.

Головне робоче меню (Плани, Планування проходів, Обладнання, Порівняти) залишається доступним, оскільки воно потрібне користувачам для роботи. Приховані лише опції посвідчень, розрахунків, адміністрування та керування обліковим записом.

Повернення плану проходів

Коли користувач завершує план проходів у Launch Pad, результат має повернутися у ваш продукт. Доступні чотири способи, і вони працюють із будь-яким варіантом інтеграції. Push-варіанти значно кращі за опитування (polling).

Наскрізний потік

Що відбувається крок за кроком, коли користувач партнера відкриває Launch Pad:

sequenceDiagram
    autonumber
    participant YU as UI партнера
    participant YB as Бекенд партнера
    participant LA as Launch Pad API
    participant LU as Launch Pad UI

    YU->>YB: користувач натискає «Відкрити план проходів»

    note over YB,LA: Крок 1: створити користувача LP, якщо не існує
    YB->>LA: POST /api/users (idempotent on externalUserId)
    YB->>LA: POST /api/company-accesses (idempotent on user + org)

    note over YB,LA: Крок 2 (опціонально): передати межу поля
    YB->>LA: POST /api/vBoundary/upsert

    note over YB,LA: Крок 3: запросити код запуску
    YB->>LA: POST /api/partner/launch ({ userId, companyId, returnUrl })
    LA-->>YB: { code, expiresInSec: 600 }

    YB-->>YU: 302 redirect to https://your-app.vergeag.com/launch?code=...
    YU->>LU: браузер переходить на /launch?code=...
    LU->>LA: POST /api/partner/launch/{code}/exchange
    LA-->>LU: JWT + refresh token
    note over LU: зберегти JWT у localStorage,
видалити код з URL,
перейти на returnUrl
          

Ключові властивості

• Ви автентифікуєтесь сервер-сервер з довготривалим обліковим записом (API-ключ вашого адміністратора). Браузер ніколи не бачить API-ключ.
• Браузер бачить лише короткоживучий одноразовий непрозорий код в URL (час життя 10 хвилин, знищується при обміні).
• Ендпоінт обміну не вимагає входу; сам код є обліковим записом. UI Launch Pad викликає його, щойно користувач потрапляє на сторінку.
• Launch Pad видає звичайну користувацьку сесію (JWT + refresh token), зберігає її в localStorage і перенаправляє користувача на вказаний вами URL.

Відповідність стандартам

Як виглядає URL переадресації

Що отримує браузер користувача (один рядок у вигляді заголовка Location:):

https://your-app.vergeag.com/launch?code=lc_R3w9q-Kx7VtNm2bH8sLpYj4eQ6gZc1aXfU0dT5nMoP&returnUrl=%2Fpath-planning%2Fboundary%2Fb3f47e1c-8a02-4d59-9c6e-2f7a8b1d6e09

У розшифрованому для читання вигляді:

Що робить UI Launch Pad при переході

Ви це не реалізуєте; інформація наведена для довідки, щоб ви розуміли, що відбувається у ваших користувачів між кліком і відображенням поля:

1. Читає code і returnUrl з рядка запиту.
2. Обмінює код з Launch Pad на користувацьку сесію.
3. Авторизує користувача в потрібній організації клієнта.
4. Видаляє код з адресного рядка, щоб він не залишався в історії браузера.
5. Перенаправляє користувача на вказаний вами returnUrl.

Якщо code відсутній, закінчився або вже використаний, користувач потрапляє на сторінку помилки з проханням повернутися у ваш продукт і спробувати ще раз.

Варіанти повернення детально

Інші варіанти інтеграції

Ця сторінка є повним описом запуску одним кліком. Якщо вашому продукту потрібно менше або більше: