Integrationsmodell wählen

Die eigentliche Inspektion wird immer von einer berechtigten Person in der TrakarIA-Anwendung abgeschlossen. Die erste Entscheidung lautet: Wer erstellt den Rental-Vorgang und bereitet die Inspektion vor? API-Anbindung und Startschaltfläche sind getrennte Entscheidungen.

Modell	Aufgabe Ihres Systems	Aufgabe des Mitarbeiters	Geeignet für
Nur Anwendung	Keine öffentliche API: Es wird keine Buchung synchronisiert	Wählt oder erstellt das Fahrzeug, beginnt Abfahrt und Rückgabe und erfasst die benötigten Angaben in TrakarIA	Team ohne Anbindung an ein Vermietsystem
API ohne Schaltfläche	Synchronisiert Fahrzeug und Vorgang; die Reservierung erscheint sofort in der Planung; bereitet Abfahrt und Rückgabe per API vor	Sieht die Reservierung in der Planung, findet die vorbereitete Inspektion und validiert sie	Angebundene Software; Team arbeitet bereits in TrakarIA
API mit Schaltfläche	Führt dieselbe Planungs-Synchronisierung und Vorbereitung aus und zeigt danach die zurückgegebene launch_url	Öffnet den Link, meldet sich an und validiert in TrakarIA	Vermietsoftware mit Schaltfläche „Inspektion öffnen“

Webhooks und das Lesen von Berichten per API stehen in beiden angebundenen Modellen zur Verfügung. Zum Empfang von Benachrichtigungen muss ein Webhook-Ziel konfiguriert werden; die Synchronisierung allein erzeugt keines. Im Modell „Nur Anwendung“ erhält das Vermietsystem nichts automatisch. Nur in der Anwendung erstellte Zyklen werden nicht automatisch zu /v1/rentals-Vorgängen, wenn später eine API-Integration ergänzt wird.

Verknüpfter Ablauf

1. Ihr Backend sendet mit dem Gruppen-API-Schlüssel den Fahrzeug- und Rental-Kontext. Der Vorgang erscheint sofort in der Planung. Nur die externe Fahrzeugkennung ist im Anfragetext erforderlich; der übrige Kontext kann im Voraus, bei der Übergabe oder später mit einer neueren Quellrevision gesendet werden. Dies geschieht serverseitig, niemals im Kundenbrowser.
2. Das Backend ruft POST /v1/rentals/{rental_id}/inspections mit type: departure oder return und einem Idempotency-Key auf.
3. Die Antwort enthält eine Inspektionskennung und eine kurzlebige launch_url. Ihre Anwendung kann eine Schaltfläche anzeigen, die diesen Link öffnet. Unterstützt werden ein neuer Tab oder normale Navigation.
4. Der Link führt zum passenden TrakarIA-Ablauf. Besteht keine aktive Sitzung, meldet sich der Mitarbeiter an. TrakarIA prüft Gruppenmitgliedschaft und Berechtigungen der Person, bevor die Arbeit fortgesetzt wird.
5. Nach der menschlichen Validierung erhält das Backend ein signiertes Abschlussereignis oder holt verpasste Ereignisse über GET /v1/events nach und lädt anschließend den Bericht über die authentifizierte API.

Der Startlink läuft ab und kann mit POST /v1/inspections/{inspection_id}/launch erneuert werden. Er hilft bei der Navigation und ist kein Zugangstoken. Halten Sie ihn aus Protokollen, Analysen und öffentlichen Seiten heraus. Ein neuer Tab oder normale Navigation bleibt als Rückfallweg verfügbar. TrakarIA kann außerdem innerhalb Ihrer Anwendung angezeigt werden. Wenden Sie sich an den TrakarIA-Support, damit Ihre Anwendung geprüft und freigeschaltet wird; Einbettungen aus nicht genehmigten Anwendungen werden blockiert.

Übergabe an die TrakarIA-Anwendung

Arbeiten Ihre Mitarbeiter bereits in TrakarIA, benötigen Sie keine Startschaltfläche. Ihr Backend benötigt weiterhin den API-Schlüssel: Es synchronisiert Fahrzeug und Vorgang, wodurch die Reservierung sofort in der Planung erscheint, und ruft POST /v1/rentals/{rental_id}/inspections auf, bevor der Mitarbeiter die vorbereitete Inspektion in der TrakarIA-Anwendung fortsetzt. Der Mitarbeiter kann eine per API erzeugte oder manuell geplante Reservierung auch direkt aus der Planung öffnen und dort Checkout starten. Wird Checkout ohne ausdrückliche Planungsauswahl begonnen, zeigt TrakarIA die verfügbaren Reservierungen des Fahrzeugs und erlaubt außerdem einen unabhängigen Walk-in-Checkout. Diese Zuordnung liefert Kontext; sie ist niemals eine Voraussetzung, die die physische Übergabe blockiert. Die Synchronisierung darf im Voraus oder bei der tatsächlichen Übergabe erfolgen. Die Schaltfläche öffnet lediglich dieselbe Inspektion direkt. Die ausführlichen Szenarien grenzen dies vom vollständig manuellen Ablauf ab.

Wann Rückmeldungen sinnvoll sind

Verwenden Sie Webhooks, wenn Ihr System schnell auf eine Validierung reagieren soll. Behandeln Sie sie als Benachrichtigungen: Signatur prüfen, anhand der Ereigniskennung deduplizieren und aktuelle Ressource abrufen. GET /v1/events dient zur Wiederherstellung nach Ausfällen. rental.departure.completed bedeutet, dass das Abfahrts-JSON bereit ist; rental.return.completed bedeutet, dass das Vergleichs-JSON bereit ist. Die PDF-Bereitschaft besitzt ein eigenes Ereignis und kann später eintreffen.