--- title: "API-Keys" description: "Erstellen, rotieren, umstellen und löschen Sie die API-Keys Ihrer Organisation und Ihrer Carrier in Orbit MissionControl, und sehen Sie den Verlauf jedes Keys." url: "https://support.pr-9.orbit.do/de/advanced-features/api-keys" locale: "de" apps: ["mission"] lastReviewed: "2026-10-21" --- # API-Keys Erstellen, rotieren, umstellen und löschen Sie die API-Keys Ihrer Organisation und Ihrer Carrier in Orbit MissionControl, und sehen Sie den Verlauf jedes Keys. Mit einem API-Key arbeitet ein anderes System mit Orbit, ohne dass sich eine Person anmeldet: Ihr TMS oder ERP über die Operator-API, oder die Telematik eines Carriers über die Carrier-API. Alle Keys Ihrer Organisation und Ihrer Carrier verwalten Sie in Orbit MissionControl unter **Einstellungen** > **API-Keys**. **Das Wichtigste:** * **Zwei Arten von Keys:** **Operator-Keys** öffnen die Operator-API für Ihre ganze Organisation. **Carrier-Keys** gehören einem Carrier und sehen nur dessen Touren. * **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. ## Die Liste Die Seite öffnet mit **Operator-Keys**. Wählen Sie **Carrier-Keys**, um die Keys Ihrer Carrier zu sehen, mit der Spalte **Carrier**. Das Suchfeld rechts findet Keys nach Namen; bei **Carrier-Keys** bietet es auch Carrier an, damit Sie die Liste auf einen oder mehrere davon eingrenzen. Jede Zeile zeigt den Namen des Keys, seine Rolle, das Ende des Keys, wann er zuletzt benutzt wurde und wann er abläuft. Eine Zeile kann diese Marker tragen: | Marker | Bedeutung | | ---------------------- | ------------------------------------------------------------------------------------------------------------------------------- | | **Rotation empfohlen** | Ein Key aus der Zeit, bevor Orbit Keys als Fingerabdruck speicherte. Er funktioniert weiter; rotieren Sie ihn, wenn Sie können. | | **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. | | **Deaktiviert** | Der Carrier ist deaktiviert. Die Carrier-API lehnt seine Keys ab, bis er wieder aktiv ist. | **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 **Einstellungen** > **API-Keys** und wählen Sie **Operator-Keys** oder **Carrier-Keys**, je nachdem, welchen Key Sie brauchen. 2. Wählen Sie **API-Key erstellen**. Über der Liste öffnet sich eine Karte. 3. Geben Sie einen **Name** ein, der sagt, wo der Key benutzt wird, zum Beispiel `Telematik Nordlicht`. Wählen Sie bei einem Carrier-Key den **Carrier**. 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 das andere 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 MissionControl in der Ansicht Carrier-Keys, mit einem Carrier im Suchfeld und zwei Keys dieses Carriers](https://support.pr-9.orbit.do/images/api-keys/carrier-keys.png) *Die Carrier-Keys eines Carriers: 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 die Rollen an, die ein Key dieser Art haben kann: * **Operator API Key Full Access** und **Operator API Key Read Only** für Operator-Keys, **Carrier API Key Full Access** und **Carrier API Key Read Only** für Carrier-Keys. Diese Rollen gibt es nur für API-Keys, und sie wachsen mit neuen Funktionen mit. * Ihre eigenen Rollen unter **Eigene Rollen**, wenn sie für dieselbe Nutzerart gedacht sind und keine Bedingung enthalten, die einen einzelnen Nutzer oder ein Team nennt. Sie legen sie unter **Einstellungen** > **Rollen** an; siehe [Rollen und Berechtigungen](https://support.pr-9.orbit.do/de/advanced-features/roles-and-permissions). 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 im anderen System ein, bevor der alte abläuft. Die Liste zeigt danach den neuen Key und darunter den alten mit seinem Ablaufdatum. 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, bis zum ersten. ## Beispiel Spaceport Shipping Co. bindet sein Lagersystem in Lyon mit einem Operator-Key an, der nie abläuft. Der Carrier Northern Light Transport bekommt einen Carrier-Key mit **Carrier API Key Read Only**, damit seine Telematik in Hamburg seine Touren lesen kann. Als Julia, die die Telematik eingerichtet hat, das Unternehmen verlässt, rotiert Max den Carrier-Key mit einer Überlappung von 24 Stunden und schickt dem Carrier den neuen Key. ## Technische Details Operator-Keys funktionieren mit der Orbit API; siehe die [Orbit API Reference](https://orbit-api.readme.io/). 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: Was passiert mit einem Key, wenn die Person, die ihn erstellt hat, das Unternehmen verlässt?** Nichts. Ein Key gehört Ihrer Organisation oder dem 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. **Q: Was passiert mit den Keys eines Carriers, wenn ich den Carrier deaktiviere?** Die Carrier-API lehnt sie ab, solange der Carrier deaktiviert ist. Die Liste markiert sie mit **Deaktiviert**.