--- title: "API-Keys in Orbit Connect" description: "Erstellen, rotieren, umstellen und löschen Sie die API-Keys Ihres Carriers in Orbit Connect, damit Ihr TMS oder Ihre Telematik Ihre Touren lesen und aktualisieren kann." url: "https://support.pr-5.orbit.do/de/advanced-features/api-keys-in-connect" locale: "de" apps: ["connect"] lastReviewed: "2026-10-23" --- # API-Keys in Orbit Connect Erstellen, rotieren, umstellen und löschen Sie die API-Keys Ihres Carriers in Orbit Connect, damit Ihr TMS oder Ihre Telematik Ihre Touren lesen und aktualisieren kann. Mit einem API-Key arbeiten Ihre eigenen Systeme mit Orbit, ohne dass sich eine Person anmeldet: Ihr TMS liest die Touren, die Ihre Auftraggeber Ihnen geben, Ihre Telematik meldet, wo sie gerade sind. Als Carrier-Administrator erstellen und verwalten Sie die Keys Ihres Carriers selbst in Orbit Connect unter **API-Keys**. **Das Wichtigste:** * **Nur die Keys Ihres Carriers:** Ein Key gehört Ihrem Carrier und sieht nur dessen Touren. Sie sehen und ändern nur die Keys Ihres eigenen Carriers. * **Einmal angezeigt:** Orbit speichert von einem Key nur einen Fingerabdruck. Den Key selbst sehen Sie genau einmal, direkt nach dem Erstellen oder Rotieren. Danach zeigt die Liste nur seinen Anfang und seine letzten vier Zeichen, zum Beispiel `orb_car_live_…7Fq2`. * **Eine Rolle je Key:** Jeder Key hat eine Rolle, die Sie beim Erstellen wählen und später ändern können. * **Rotieren ohne Ausfall:** Rotieren erstellt einen neuen Key, und der alte funktioniert noch für eine Überlappung, die Sie wählen. ## Wer Keys verwaltet **API-Keys** erscheint in der Navigation von Orbit Connect unter **Fahrzeuge**, für Carrier-Administratoren. Andere Nutzer Ihres Carriers sehen den Punkt nicht. Ihr Auftraggeber, das Unternehmen, das Ihnen die Touren gibt, kann Ihre Keys ebenfalls verwalten, in Orbit MissionControl. ## Die Liste Jede Zeile zeigt den **Name** des Keys, seine **Rolle**, das Ende des **Key**, wann er **Zuletzt benutzt** wurde und wann er abläuft (**Läuft ab**). Eine Zeile kann diese Marker tragen: | Marker | Bedeutung | | ---------------------- | ------------------------------------------------------------------ | | **In 5 Tagen** | Der Key läuft in weniger als sieben Tagen ab. | | **Läuft ab am 20.10.** | Der alte Key einer Rotation, der bis zu diesem Datum funktioniert. | | **Abgelaufen** | Der Key funktioniert nicht mehr. Die Zeile ist ausgegraut. | **Zuletzt benutzt** wird höchstens alle 15 Minuten aktualisiert. Ein Key, der ständig benutzt wird, kann deshalb eine Zeit von vor ein paar Minuten zeigen. ## Einen Key erstellen 1. Öffnen Sie in Orbit Connect **API-Keys** in der Navigation. 2. Wählen Sie **API-Key erstellen**. Über der Liste öffnet sich die Karte **Neuer API-Key**. 3. Geben Sie einen **Name** ein, der sagt, wo der Key benutzt wird, zum Beispiel `Telematik Nordlicht`. 4. Wählen Sie die **Rolle** und wann der Key abläuft (**Läuft ab**): **Nie**, **In 30 Tagen**, **In 90 Tagen** oder **In 365 Tagen**. 5. Wählen Sie **Erstellen**. Ein Dialog zeigt den Key. Kopieren Sie ihn mit **Kopieren** und legen Sie ihn dort ab, wo Ihr System ihn lesen kann. Wählen Sie dann **Ich habe den Key gespeichert**. > **Warning:** Der Dialog ist der einzige Ort, an dem der Key angezeigt wird. Schließen Sie ihn, ohne den Key zu speichern, löschen Sie den Key und erstellen Sie einen neuen. ![Die Seite API-Keys in Orbit Connect mit drei Keys des Carriers, der alte Key einer Rotation ausgegraut mit seinem Ablaufdatum](https://support.pr-5.orbit.do/images/api-keys-in-connect/connect-keys.png) *Die API-Keys eines Carriers in Orbit Connect: der neue Key einer Rotation über dem alten, der bis zu seinem Ablaufdatum noch funktioniert.* ## Rollen Die Rolle bestimmt, was ein Key darf. **Rolle** bietet an: * **Carrier API Key Full Access**: alles, was Ihr Carrier mit seinen Touren, Fahrern und Fahrzeugen tun darf. * **Carrier API Key Read Only**: liest dieselben Daten, ohne sie zu ändern. * Rollen, die Ihr Auftraggeber für Carrier-Keys angelegt hat, unter **Eigene Rollen**. Eigene Rollen legen Sie nicht selbst an; fragen Sie Ihren Auftraggeber, wenn Sie eine brauchen. Um die Rolle eines Keys zu ändern, öffnen Sie das Menü **…** der Zeile und wählen **Rolle ändern …**. Die neue Rolle gilt spätestens nach einer Minute. ## Einen Key rotieren Rotieren ersetzt einen Key durch einen neuen mit demselben Namen und derselben Rolle. Nutzen Sie es, wenn jemand anderes einen Key gesehen haben könnte, oder regelmäßig als Vorsorge. 1. Öffnen Sie das Menü **…** der Zeile und wählen Sie **Rotieren …**. 2. Wählen Sie, wann der alte Key abläuft: **Sofort**, **Nach 24 Stunden** oder **Nach 7 Tagen (empfohlen)**. 3. Wählen Sie **Rotieren**. Der neue Key wird einmal angezeigt, wie nach dem Erstellen. Tragen Sie ihn in Ihrem System ein, bevor der alte abläuft. Ein Key lässt sich einmal rotieren; um ihn noch einmal zu ersetzen, rotieren Sie den neuen Key. Ein abgelaufener Key lässt sich nicht rotieren. ## Einen Key löschen Öffnen Sie das Menü **…** der Zeile, wählen Sie **Löschen …** und bestätigen Sie mit **Löschen**. Systeme mit diesem Key verlieren spätestens nach einer Minute den Zugriff. Ein gelöschter Key lässt sich nicht wiederherstellen. ## Verlauf Wählen Sie **Verlauf** im Menü **…** einer Zeile, um zu sehen, was mit einem Key geschehen ist: wann er angelegt, rotiert, umgestellt oder gelöscht wurde, und von wem. Der Verlauf eines rotierten Keys zeigt auch die Keys, die er ersetzt hat. ## Beispiel Nordlicht Spedition in Hamburg fährt Touren für ein Logistikunternehmen. Die Administratorin Julia erstellt einen Key `Telematik` mit **Carrier API Key Full Access** für das Telematiksystem und einen zweiten Key mit **Carrier API Key Read Only** für eine Planungstabelle in Bremen. Als der Telematikanbieter wechselt, rotiert Julia den ersten Key mit einer Überlappung von 24 Stunden und trägt den neuen Key im neuen System ein. ## Technische Details Carrier-Keys funktionieren mit der Carrier-API. Die Seite verlinkt ihre Referenz unter **Zur Carrier-API**. Senden Sie den Key im Header `x-api-key`. **Q: Kann ich einen Key noch einmal sehen, nachdem ich den Dialog geschlossen habe?** Nein. Orbit speichert von jedem Key nur einen Fingerabdruck, deshalb kann niemand ihn erneut anzeigen. Rotieren Sie den Key oder erstellen Sie einen neuen. **Q: Kann ich die Keys eines anderen Carriers verwalten?** Nein. Sie sehen und ändern nur die Keys Ihres eigenen Carriers, und jeder Key, den Sie erstellen, gehört Ihrem Carrier. **Q: Was passiert mit einem Key, wenn die Person, die ihn erstellt hat, das Unternehmen verlässt?** Nichts. Ein Key gehört Ihrem Carrier, nicht einer Person, und funktioniert weiter. **Q: Warum funktioniert ein Key direkt nach dem Löschen oder einem Rollenwechsel noch?** Orbit merkt sich einen Key bis zu einer Minute. Danach gilt für jede Anfrage der neue Stand. Related: [API-Keys](https://support.pr-5.orbit.do/de/advanced-features/api-keys)