Launch Pad partner integration demo
This app plays the role of "Your Ag App" - a partner product that adds Launch Pad path planning to its own software. It makes real calls to the Launch Pad public REST API and shows you every request and response in a live log, so you can see exactly what your integration needs to do.
The whole integration is three steps
- Connect - your server authenticates with an API key (one-time setup, right below).
- The plumbing - your backend provisions Grower > Farm > Field > Boundary (GFFB) through the API, invisibly to your users.
- The handoff - your app sends the user to Launch Pad with their boundary already loaded: a new browser window (companion mode) or an iframe in your own UI (embedded mode). Partner mode goes further: it also provisions the user and their org from your own ids and signs them in automatically with a single-use launch code.
The checklist in the sidebar tracks these steps as you walk through the demo, and maps one-to-one to the sequence diagram on How it works.
Start here: connect your API key
Everything below needs it. Create an API key in Launch Pad (sign in at app.vergeag.com/api-keys) and paste it here. The key stays in this tab's sessionStorage only.
1. Companion mode
Your app provisions the grower, farm, field, and boundary over the API, then opens Launch Pad in a new browser window, deep-linked straight to path planning for that boundary.
Try companion mode2. Embedded mode
Same provisioning, but Launch Pad renders inside your own UI in an iframe, with its navigation chrome hidden and a partner theme applied.
Try embedded mode3. Partner mode
The full partner integration: provision users and orgs from your own external
ids through /api/partner/*, then hand off with
auto sign-in via a single-use launch code - no Launch Pad sign-up or
sign-in, ever.