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

Демо интеграции для партнёров

Небольшое демонстрационное приложение, которое показывает, что нужно, чтобы встроить планирование проходов 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, со скрытой навигацией и применённой партнёрской темой.