/ Розробникам / Демо для партнерів

Демо інтеграції для партнерів

Невеликий демонстраційний застосунок, який показує, що потрібно, щоб вбудувати планування проходів Launch Pad у ваш власний продукт. Він грає роль вигаданого партнера, «Your Ag App», виконує реальні виклики публічного REST API Launch Pad і показує кожен запит та відповідь у живому журналі. Пройдіть демо зі своїм API-ключем, а потім почитайте вихідний код.

Відкрити живе демо Читати вихідний код GitHub - незабаром

Працює в браузері, нічого встановлювати не треба. Потрібен API-ключ Launch Pad із позначкою Partner Admin; зверніться до служби підтримки API Verge Ag, щоб її отримати.

Навіщо це демо

Партнери додають планування проходів Launch Pad у свій продукт, не розробляючи планування проходів самостійно, а їхні користувачі ніколи не завантажують файл межі поля й не створюють обліковий запис. Це демо існує, щоб ваші розробники побачили всю інтеграцію від початку до кінця, з реальним API-трафіком, перш ніж написати бодай рядок коду. Оцінити обсяг роботи можна приблизно за десять хвилин.

Увесь процес - це три кроки

1

Налаштування

Ваш бекенд автентифікується як ваш сервісний обліковий запис Partner Admin: один привілейований API-ключ, який надсилається в заголовку X-API-KEY з кожним запитом. Ваші користувачі ніколи не мають ключів.

2

Підготовка

Від імені цього облікового запису створіть усе ще до появи вашого користувача: самого користувача, його компанію/організацію та його доступ, а потім землю - company/organization > grower > farm > field > boundary (CGFFB). Жодного створення облікового запису й жодного завантаження межі поля вашими користувачами, ніколи.

3

Передача

Запросіть одноразовий код запуску й відкрийте Launch Pad із входом від імені вашого користувача: людини, яка користується вашим застосунком, тієї самої, яку ви підготували на кроці 2. Користувач одразу потрапляє на ту саму межу поля. Без реєстрації, без екрана входу, без імпорту.

Вирішіть, як показувати Launch Pad

A. Режим companion (нове вікно браузера)

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

B. Вбудований режим (iframe у вашому інтерфейсі)

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