Die Aktivierung per E-Mail über die API wird dort benötigt, wo die Registrierung per E-Mail statt per Telefon bestätigt wird: E-Mail-Clients, Werbekonten ohne Telefonverifizierung, Foren und Dienste, bei denen der Code oder Link ausschließlich per E-Mail eintrifft. Wir erklären, wie der Ablauf der Postfachanfrage für die E-Mail-Aktivierung aufgebaut ist, was die häufigsten Antwortcodes bedeuten und wie Sie den Status abfragen, ohne an das Anfragelimit zu stoßen.

Lebenszyklus einer E-Mail-Aktivierung: von der Anfrage bis zum Code

Der Ablauf besteht aus vier Schritten. Zunächst fordert der Client ein Postfach für eine bestimmte Website an – in den Anfrageparametern wird der Dienst übergeben, für den die Registrierung nötig ist. Das System reserviert eine freie Adresse und gibt eine Aktivierungs-ID zurück: Ab diesem Moment ist das Postfach dem Auftrag zugeordnet und wird nicht parallel an einen anderen Kunden vergeben. Der zweite Schritt ist das Warten auf die E-Mail: Die Zielwebsite sendet die Bestätigung an die vergebene Adresse, und das kann je nach Geschwindigkeit des Absenders von wenigen Sekunden bis zu ein paar Minuten dauern. Der dritte Schritt ist der Abruf des Codes: Sobald die E-Mail zugestellt ist, liefert die API den Code oder Link aus der E-Mail, je nach Bestätigungsformat der jeweiligen Website. Der vierte Schritt ist der Abschluss der Aktivierung, wenn der Code gepasst hat, oder die Stornierung, wenn die Registrierung fehlgeschlagen ist und das Postfach vorzeitig freigegeben werden soll, ohne den Ablauf der Frist abzuwarten.

Warum das Postfach nur E-Mails von angegebenen Websites annimmt

Bei der Bestellung einer E-Mail-Aktivierung geben Sie die Website oder eine Liste von Websites an, für die das Postfach eingehende E-Mails annehmen soll. Das ist keine technische Einschränkung, sondern ein bewusster Absenderfilter: E-Mails von Quellen außerhalb der Liste werden nicht verarbeitet und nicht über die API ausgegeben. Dahinter stehen zwei Gründe. Erstens kann ein physisches Postfach parallel Aufträge für verschiedene Dienste bedienen, ohne dass E-Mails zwischen Kunden verwechselt werden. Zweitens schützt der Filter vor Massenmails und Phishing-Nachrichten, die sonst die Eingangswarteschlange verstopfen und die Verarbeitung der Post verlangsamen würden. Gehört die Website, bei der Sie sich registrieren, nicht zu der bei der Bestellung angegebenen Liste, gelangt die E-Mail schlicht nicht in die API-Ausgabe – das sollten Sie als Erstes prüfen, wenn der Code lange auf sich warten lässt.

Häufige Antwortcodes und ihre Bedeutung in der Praxis

Der Code „keine freien Postfächer“ bedeutet, dass der Adresspool für die jeweilige Website vorübergehend erschöpft ist: Warten Sie entweder ein bis zwei Minuten und wiederholen Sie die Anfrage oder, sofern der Dienst es zulässt, stellen Sie den Auftrag für eine benachbarte Website derselben Familie. Der Code „E-Mail ist noch nicht eingetroffen“ ist ein normaler Zwischenzustand und kein Fehler: Die Aktivierung ist angelegt, das Postfach wartet auf Eingang, und eine erneute Abfrage nach einem angemessenen Intervall liefert früher oder später den fertigen Code. Der Code „Aktivierung abgelaufen“ erscheint, wenn die E-Mail nicht innerhalb der vorgesehenen Zeit eingetroffen ist: Das Limit existiert, damit Postfächer nicht endlos für vergessene Aufträge blockiert bleiben, und nach Ablauf der Frist kehrt die Adresse in den gemeinsamen Pool zurück. Der Code „Stornierung verbucht“ bestätigt, dass Sie die Aktivierung selbst vorzeitig beendet haben – der grundlegende Unterschied zum Ablauf besteht darin, dass die Initiative vom Kunden ausgeht und nicht vom Zeitlimit des Systems. Wenn der Pool dauerhaft länger als üblich leer ist, klären Sie per Ticket beim Support, ob für die gewünschte Website mit einer Auffüllung zu rechnen ist – das geht schneller als manuelles Durchprobieren von Anfragen.

Wie Sie den Status abfragen, ohne unnötige Last zu erzeugen

Eine häufige Ursache für eine fehlerhafte Integration ist die Statusabfrage der Aktivierung in einer Schleife ohne Pause, mehrmals pro Sekunde. Das beschleunigt die Zustellung der E-Mail nicht: Die Geschwindigkeit hängt davon ab, wie schnell die Absender-Website die E-Mail selbst erzeugt und versendet, und nicht davon, wie oft Sie die API aufrufen. Ein vernünftiges Intervall ist eine Abfrage alle paar Sekunden, mit schrittweise länger werdender Pause, wenn sich der Status lange nicht ändert. Dieser Modus bleibt innerhalb des Anfragelimits, erzeugt keine Warteschlange identischer Aufrufe und unterscheidet sich in der Geschwindigkeit, mit der der Code eintrifft, nicht von dichter Abfrage – der Unterschied zeigt sich nur in der Zahl der verbrauchten Anfragen. Dasselbe Prinzip gilt auch bei anderen APIs des Katalogs, etwa bei der Einrichtung der IP-Rotation per API: Häufiges Abfragen beschleunigt das Ergebnis nicht, sondern verbraucht nur das Limit.

E-Mail-Aktivierung versus SMS-Aktivierung in der Automatisierung

Bei der Massenregistrierung lösen E-Mail und SMS unterschiedliche Aufgaben und werden meist gemeinsam eingesetzt. Die SMS-Aktivierung ist an eine Telefonnummer gebunden: Der Code geht an eine bestimmte virtuelle Leitung, die für die Dauer der Aktivierung zur Verfügung steht, und die Kosten hängen von Land und Dienst ab. Die E-Mail-Aktivierung ist an ein E-Mail-Postfach gebunden, das während der Mietdauer mehrere E-Mails von einer oder mehreren angegebenen Websites empfangen kann. Dieses Modell ist besonders nützlich, wenn die Bestätigung verzögert eintrifft, einen Klick auf einen Link statt der Eingabe eines kurzen Codes erfordert oder der Dienst gar keine Telefonnummer verlangt. Ein ähnlich aufgebauter Ansatz wird auch bei anderen APIs des Katalogs verwendet – zum Beispiel im Zyklus von Vergabe und Verlängerung von Proxy-Kanälen über die API: Bestellung, Nutzung, Verlängerung oder Verzicht auf die Ressource ohne manuellen Eingriff. Bei der Planung der Registrierungsautomatisierung sollten Sie beide Kanäle parallel vorsehen: Sie ergänzen sich, und die Wahl hängt davon ab, was die jeweilige Website konkret verlangt.

Häufig gestellte Fragen

Kann ein Postfach für mehrere Websites gleichzeitig verwendet werden?

Ja, wenn Sie bei der Bestellung mehrere Websites in der Liste der zulässigen Absender angegeben haben – das Postfach nimmt im Rahmen einer Miete E-Mails von jeder davon an, ohne dass für jeden Dienst eine eigene Adresse bestellt werden muss.

Was tun, wenn der Code eingetroffen ist, auf der Website aber nicht passt?

Prüfen Sie zunächst, ob der Code auf Seiten der Website selbst zeitlich abgelaufen ist – bei vielen Diensten ist die Gültigkeit des Codes unabhängig von der API kurz. Ist der Code aktuell und wird trotzdem nicht akzeptiert, wurde die E-Mail wahrscheinlich von einer anderen Adresse dupliziert oder die Website verwendet ein nicht standardmäßiges Format – gleichen Sie dann mit der vollständigen E-Mail ab und nicht mit einem herausgeschnittenen Ausschnitt.

Woran erkenne ich, dass Anfragen zu häufig an die API gesendet werden?

Ein Anzeichen sind Codes zur Anfragebegrenzung statt des erwarteten Aktivierungsstatus. Tritt das regelmäßig auf, vergrößern Sie das Intervall zwischen den Abfragen, besonders in der Phase des Wartens auf die E-Mail, in der sich der Zustand objektiv nicht schneller ändern kann, als die Absender-Website die E-Mail selbst erzeugt.

Die vollständige Beschreibung der Methoden, der Parameter für die Postfachanfrage und den Abschluss der Aktivierung finden Sie in der technischen Dokumentation der API.