Fügen Sie Ihrer Plattform Wegplanung hinzu

Überblick

Jede Stufe funktioniert eigenständig. Die meisten Partner beginnen mit Stufe 1 (Ein-Klick-Start) und ergänzen später höhere Stufen, wenn sich ihre Anforderungen ändern. Die folgenden Abschnitte beschreiben, was Ihre Endnutzer erleben, was Sie als Unternehmen erhalten, die vollständige Aufschlüsselung aller vier Stufen sowie eine eingehende Betrachtung von Stufe 1. Der Abschnitt Technische Details weiter unten enthält die technische Spezifikation.

Was Ihre Nutzer erleben

In Stufe 1 fungiert Launch Pad als Begleit-App zu Ihrem Produkt. Es öffnet sich in einem neuen Browserfenster, wobei die gesamte Einrichtung im Hintergrund erfolgt, sodass der Nutzer sofort mit der Arbeit beginnen kann.

Was Sie als Partner erhalten

Entwickelt für Unternehmen und Engineering-Teams, die Precision-Routing einbinden möchten, ohne die dafür nötige Infrastruktur selbst aufzubauen.

Vier Integrationsstufen

Jede Stufe funktioniert eigenständig. Die meisten Partner beginnen mit Stufe 1 und ergänzen später höhere Stufen, wenn sich ihre Anforderungen ändern.

Wie Stufe 1 Reibung beseitigt

Warum es Stufe 1 gibt

Kontomodell

Ein Stufe-1-Engagement ist wie folgt aufgebaut:

Was Nutzer in Launch Pad sehen

Wenn ein Nutzer Launch Pad über Stufe 1 öffnet, treffen einige Launch Pad-Optionen nicht zu und werden ausgeblendet:

• Keine Passwortänderung, keine E-Mail- oder Kontoverwaltung, keine Registrierung. Der Nutzer hat kein Launch Pad-Passwort; die Anmeldung stammt aus Ihrem Produkt. Der Bildschirm zur Passwortänderung zeigt die Meldung "Passwort verwaltet von [Partner]" an, genauso wie Launch Pad bereits Nutzer behandelt, die sich über John Deere, Trimble oder CNH anmelden.
• Kein Unternehmenswechsler. Die Sitzung ist für diesen Besuch auf eine einzige Kunden-Organisation festgelegt.
• Die Abmeldung wird durch "Zurück zu [Partner]" ersetzt, was die Registerkarte schließt oder den Nutzer zu einer von Ihnen angegebenen URL zurücksendet, anstatt ihn auf der Launch Pad-Anmeldeseite zu belassen.

Das Hauptmenü für die Arbeit (Pläne, Wegplanung, Maschinen, Vergleichen) bleibt verfügbar, da Nutzer es benötigen, um die Arbeit zu erledigen. Nur Optionen für Identität, Abrechnung, Administration und Kontoverwaltung werden ausgeblendet.

Rückgabe eines Wegplans

Sobald ein Nutzer einen Wegplan in Launch Pad fertiggestellt hat, muss das Ergebnis zurück in Ihr Produkt gelangen. Vier Optionen stehen zur Verfügung, und sie funktionieren bei jeder Stufe. Push-Optionen werden gegenüber dem Polling deutlich bevorzugt.

End-to-End-Ablauf

Was Schritt für Schritt passiert, wenn ein Partner-Nutzer Launch Pad öffnet:

sequenceDiagram
    autonumber
    participant YU as Partner UI
    participant YB as Partner-Backend
    participant LA as Launch Pad API
    participant LU as Launch Pad UI

    YU->>YB: Nutzer klickt auf "Wegplan öffnen"

    note over YB,LA: Schritt 1: LP-Nutzer anlegen, falls nicht vorhanden
    YB->>LA: POST /api/users (idempotent auf externalUserId)
    YB->>LA: POST /api/company-accesses (idempotent auf Nutzer + Org)

    note over YB,LA: Schritt 2 (optional): eine Feldgrenze senden
    YB->>LA: POST /api/vBoundary/upsert

    note over YB,LA: Schritt 3: einen Start-Code anfordern
    YB->>LA: POST /api/partner/launch ({ userId, companyId, returnUrl })
    LA-->>YB: { code, expiresInSec: 600 }

    YB-->>YU: 302 Weiterleitung zu https://your-app.vergeag.com/launch?code=...
    YU->>LU: Browser navigiert zu /launch?code=...
    LU->>LA: POST /api/partner/launch/{code}/exchange
    LA-->>LU: JWT + refresh token
    note over LU: JWT in localStorage speichern,
Code aus URL entfernen,
zu returnUrl navigieren
          

Zentrale Eigenschaften

• Sie authentifizieren sich Server-zu-Server mit einer langlebigen Anmeldeinformation (dem API-Schlüssel Ihres Admin-Nutzers). Der Browser sieht den API-Schlüssel niemals.
• Der Browser sieht in der URL nur einen kurzlebigen, einmalig verwendbaren, undurchsichtigen Code (10 Minuten Lebensdauer, beim Eintausch verbraucht).
• Der Eintausch-Endpoint erfordert keine Anmeldung; der Code selbst ist die Anmeldeinformation. Die Launch Pad-Oberfläche ruft ihn auf, sobald der Nutzer ankommt.
• Launch Pad gibt eine normale Nutzersitzung aus (JWT + refresh token), speichert sie in localStorage und leitet den Nutzer zu der von Ihnen angegebenen URL.

Ausrichtung an Standards

Wie die Weiterleitungs-URL aussieht

Was der Browser des Nutzers empfängt (in einer Zeile, als Location:-Header):

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

Zur besseren Lesbarkeit dekodiert:

Was die Launch Pad-Oberfläche beim Ankommen tut

Sie implementieren dies nicht; es ist als Referenz aufgeführt, damit Sie nachvollziehen können, was Ihre Nutzer zwischen dem Klick und dem dargestellten Feld sehen:

1. Liest code und returnUrl aus der Query-Zeichenfolge.
2. Tauscht den Code bei Launch Pad gegen eine Nutzersitzung ein.
3. Meldet den Nutzer bei der richtigen Kunden-Organisation an.
4. Entfernt den Code aus der Adressleiste, damit er nicht im Browserverlauf verbleibt.
5. Sendet den Nutzer zu der von Ihnen angegebenen returnUrl.

Wenn code fehlt, abgelaufen oder bereits verwendet ist, landet der Nutzer auf einer Fehlerseite, die ihn auffordert, zu Ihrem Produkt zurückzukehren und es erneut zu versuchen.

Rückgabe-Optionen im Detail

Höhere Stufen

Diese Seite ist die vollständige Referenz für Stufe 1. Für höhere Stufen: