Zum Inhalt springen
Alpha auf Einladung. Funktionen und Grenzen können sich durch unsere Testerfahrungen ändern.

API-Schlüssel und SMTP-Zugänge

Ihre Anwendung authentifiziert sich mit einem Zugang. Es gibt zwei Arten:

Art Wofür Rechte
API-Schlüssel https://api.weneed.email Nur Senden oder Senden, E-Mail-Metadaten lesen und Verbrauch lesen
SMTP-Zugang smtp.weneed.email Nur Senden. Ein Benutzername, der mit smtp_ beginnt, und ein Passwort

Ein Zugang lässt Ihre Anwendung verbinden. Zum Senden allein reicht er nicht: Nachrichten brauchen weiterhin die Versandberechtigung des Projekts. Siehe So wird der Versand aktiviert.

Öffnen Sie Ihr Projekt, dann API keys & SMTP, dann Create API key oder Create SMTP login. Dafür brauchen Sie zuerst eine verifizierte Domain.

Geben Sie Ihre genaue Absenderadresse ein. Bei nur einer Domain und einem Stream wählt Control beide automatisch aus. Ein Label ist vorausgefüllt; Sie können es ändern. Unter Advanced settings finden Sie die optionale Gültigkeit (standardmäßig ohne Ablaufdatum; 7, 30 oder 90 Tage für vorübergehenden Zugriff) und bei API-Schlüsseln die Rechte: nur Senden oder zusätzlich Status und Verbrauch lesen.

Das Anlegen verlangt Ihren Authenticator-Code. Das Geheimnis wird einmal angezeigt. Kopieren Sie es sofort in Ihren Secret-Manager, bevor Sie die Seite verlassen; ein Neuladen oder spätere Abfragen zeigen nur die Angaben zum Zugang, nie das Geheimnis.

Geht die Antwort beim Anlegen verloren, nutzen Sie Check request result, statt das Formular erneut abzuschicken. So entstehen keine zwei Zugänge.

  • Jeder Zugang sendet von genau einer Adresse. Platzhalter-Absender gibt es nicht.
  • Eine Organisation kann bis zu 20 aktive Zugänge haben, API und SMTP zusammen.
  • Schlüssel und Passwörter haben standardmäßig kein Ablaufdatum. Ersetzen oder widerrufen Sie sie bei Bedarf. Wenn Sie eine begrenzte Gültigkeit wählen, ersetzen Sie den Zugang vor diesem Datum.

Für die Rotation oder bevor ein alter Zugang abläuft.

  1. Wählen Sie auf der Zugangskarte Replace API key oder Replace SMTP login. Das Formular ist mit den Werten des alten Zugangs vorausgefüllt.
  2. Legen Sie den Ersatz an und speichern Sie sein Geheimnis.
  3. Stellen Sie Ihre Anwendung um und prüfen Sie, ob Nachrichten angenommen werden.
  4. Widerrufen Sie den alten Zugang.

Bis Sie den alten widerrufen, funktionieren beide und beide zählen zur Grenze von 20. Sind Sie an der Grenze, widerrufen Sie zuerst einen ungenutzten Zugang. Nachrichten, die mit dem alten Zugang angenommen wurden, bleiben bei ihm; der Ersatz übernimmt sie nicht.

Wählen Sie Remove API key oder Remove SMTP login, tippen Sie REVOKE und bestätigen Sie. Danach gilt:

  • neue Anfragen mit diesem Zugang werden abgelehnt;
  • eine bereits angemeldete SMTP-Verbindung wird bei ihrer nächsten Nachricht abgelehnt;
  • noch nicht gesendete Nachrichten dieses Zugangs werden zur Prüfung zurückgehalten.

Ein Widerruf ist kein Rückruf. Eine Nachricht, die gerade zugestellt wird, kann noch ankommen.

Gerät ein Geheimnis nach außen, widerrufen Sie es sofort und legen Sie dann einen Ersatz an.

Der einmalige Schlüssel bzw. das Passwort steht oben auf der Ergebnisseite. Speichern Sie ihn, dann wählen Sie Continue to first email. Wenn Sie beide Versandmethoden gewählt haben, führt Control Sie zuerst zum zweiten Zugang. Kennungen und Verwaltungsaktionen finden Sie unter Credential details and management.