Ihr API-Key ist eine Kombination aus Buchstaben und Zahlen, die wie ein zusätzliches Passwort fungiert. Damit identifiziert sich Ihre Anwendung gegenüber unserer API und schützt Ihren Account vor Fremdzugriff. Details zur Nutzung finden Sie in der REST-API-Dokumentation.
API-Keys einsehen
Öffnen Sie Entwickler -> API-Zugang. Die Liste zeigt alle vorhandenen REST-API-Keys, Mail-API-Adressen und SMPP-Verbindungen mit Label, Umgebung (Live/Sandbox), Erstellungs- und letztem Nutzungs-Zeitpunkt. Über das Stift-Symbol rechts können Sie Label und Permissions eines Keys anpassen, über das Mülleimer-Symbol löschen Sie ihn.
Wichtig: Aus Sicherheitsgründen wird der API-Key-Wert nur einmal direkt nach dem Anlegen angezeigt. Kopieren Sie ihn sofort an einen sicheren Ort. Haben Sie ihn vergessen, müssen Sie den alten Key löschen und einen neuen anlegen.
Neuen API-Key anlegen
Klicken Sie oben rechts auf Create New und wählen Sie REST API. Im Dialog Create API Key konfigurieren Sie:
- Label zur Unterscheidung Ihrer Keys
- Environment: Live für den echten Versand, Sandbox zum Testen ohne Versand und ohne kostenpflichtige Produkte
- Key Length: empfohlen sind 64 Zeichen, kürzere Werte nur bei zwingender Notwendigkeit
- Permissions: einzeln aktivierbare Bereiche wie sms, contacts, balance, etc.
- Valid Until: Ablaufdatum oder unbegrenzt
Mit Save legen Sie den Key an. Anschließend wird der Key-Wert einmalig angezeigt - kopieren Sie ihn dann.
Empfehlung
Insbesondere bei sensiblen Datenübertragungen empfehlen wir, API-Keys regelmäßig zu rotieren: alten Key löschen, neuen anlegen, Anwendung umstellen.