Betriebshandbuch

API-Zeitüberschreitung: Wurde das Postfach schon angelegt?

Von Alexey Bulygin
Eine Lupe vor einem grünen Briefkasten neben einer Sanduhr

Eine Zeitüberschreitung zeigt nicht, ob die Postfacherstellung fehlgeschlagen ist. Ihr System braucht eine Zuordnung zwischen Kundenauftrag und Ergebnis. Trennen Sie Erstellung, Weiterleitung und Betriebsbereitschaft, damit ein Abbruch keinen unklaren zweiten Klick auf Erstellen auslöst.

Ein Programm kann über die TrekMail-API Postfächer erstellen und Weiterleitungen einrichten. Die API nimmt bestimmte Befehle Ihres Systems entgegen, statt dass jemand diese immer wieder in der Verwaltung ausführt. Änderungen benötigen Pro oder Agency, passende Rechte und Zugriff auf die gewählte Domain.

Beschreiben Sie die benötigte Ressource

Beginnen Sie mit der Aufgabe in normalen Worten. „Die Person braucht ein eigenes Arbeitskonto“ und „Nachrichten einer gemeinsamen Adresse sollen woanders ankommen“ führen zu unterschiedlichen Einstellungen.

Ein vollständiges Postfach speichert eigene Korrespondenz. Sie können eine Weiterleitung einrichten und entscheiden, ob eine lokale Kopie bleibt. Eine Weiterleitungsadresse ohne Postfach dient dagegen dem Empfang an einer Adresse mit Weitergabe, ohne dort ein eigenes Archiv zu führen. Bedingungen und Grenzen unterscheiden sich.

Trennen Sie Verwaltung und Nachrichteninhalte. Eine Adresse zu erstellen erfordert nicht automatisch das Lesen der Mitarbeiterkorrespondenz. Inhaltszugriff gehört zu eigenen API-Möglichkeiten. Geben Sie ihn keinem Programm, das nur Postfächer anlegt.

Schreiben Sie diese Unterschiede vor der Entwicklung auf. So ist klar, welche Ressource entstehen und welches Ergebnis in der Verwaltung sichtbar werden soll.

Bereiten Sie Tarif und begrenzten Zugriff vor

Eine manuell verfügbare Einstellung darf nicht automatisch über API geändert werden. Postfächer anzulegen und Weiterleitungen zu ändern benötigt Pro oder Agency. Starter erlaubt Lesen zugänglicher Infrastrukturkonfiguration, reicht für diese Automatisierung aber nicht aus.

Erstellen Sie einen eigenen Programmzugang. Beschränken Sie ihn auf benötigte Aktionen und Domains. Ein Programm für einen Agenturkunden sollte nur dessen Ressourcen bearbeiten können.

Auch die Rechte der freigebenden Person zählen. Sie kann nicht mehr Befugnisse übertragen, als sie selbst besitzt. Die API-Berechtigungsübersicht beschreibt Rechte und Tarifgrenzen.

Speichern Sie den Zugriffsschlüssel in den serverseitigen Integrationseinstellungen. Er gehört weder in das Kundenregistrierungsformular noch in die Begrüßungsmail. Für Nutzer genügen erstellte Adresse und vorgesehener Einstieg.

Legen Sie die Erstellungsschritte fest

Ermitteln Sie die erlaubte Domain aus Ihren Kundendaten. Eine im Browser übermittelte Domain-ID belegt keine Berechtigung.

Kontrollieren Sie dann, ob die Adresse existiert und Grenzen ausreichend sind. Ist ein Postfach vorhanden, klären Sie seine Zugehörigkeit zur Anfrage. Ein zweiter Klick sollte keinen unklaren Zustand erzeugen.

Richten Sie danach gegebenenfalls die Weiterleitung ein. Entscheiden Sie bei einem vollständigen Postfach vorher über die lokale Kopie. Erwartet ein Mitarbeiter dort sein Archiv, darf dies kein zufälliger Standardwert sein.

Existiert das Postfach und scheitert die Weiterleitung, erfassen Sie diesen Teilstand und beheben nur diesen Schritt. Betriebsbereit ist es nach Prüfung von Zustellung und lokaler Kopie.

Die TrekMail-API-Übersicht enthält Methoden und Anfrageformate. Sie dient als Arbeitsgrundlage für die Entwicklung, während der Nutzerablauf einfach bleibt.

Planen Sie Wiederholungen und Fehler

Bei einer als idempotent dokumentierten Operation behalten Sie den Idempotency-Key für denselben Auftrag und Inhalt bei. Speichern Sie die Postfach-ID und prüfen Sie Wiederholungsregeln anderer Operationen separat.

In anderen Fällen muss die Integration zuerst nach der gewünschten Ressource suchen. Wiederholen Sie nicht bei jeder unklaren Antwort blind die Erstellung. Speichern Sie den Zusammenhang zwischen Anfrage und Ergebnis, um am richtigen Schritt fortzusetzen.

Behandeln Sie fehlenden Speicher, erreichte Grenzen und verweigerten Zugang getrennt. Identische Wiederholungen beheben diese Ursachen nicht. Eine verständliche Meldung mit zuständiger Person ist hilfreicher als endloses „Postfach wird erstellt“.

Versprechen Sie bei großen Gruppen keine gleiche Bearbeitungszeit. Zeigen Sie den Zustand jeder Anfrage und die Fälle, die Aufmerksamkeit brauchen.

Testen Sie zuerst eine Domain

Beginnen Sie mit einer Testdomain und einigen Adressen. Prüfen Sie normale Erstellung, dieselbe Anfrage erneut und einen Zugriff auf eine nicht freigegebene Domain.

Senden Sie dann eine Nachricht an die erstellte Adresse. Bei Weiterleitung prüfen Sie Endempfänger und lokale Kopie gemäß dem gewählten Modus. Eine erfolgreiche API-Antwort ersetzt keinen E-Mail-Test.

Legen Sie vor dem Start fest, wer Fehler sieht und manuell korrigieren kann. Führen Sie ein Anfrageprotokoll ohne geheime Schlüssel und Passwörter. Läuft der kleine Prozess verlässlich, kann er Teil der Mitarbeiter- oder Kundeneinrichtung werden.

Nutzen Sie den API-Überblick. Infrastruktur anzulegen erfordert keinen Zugriff auf Nachrichten des neuen Nutzers; vergeben Sie nur die nötigen Rechte.

Weiterlesen

Diesen Artikel teilen

Bei TrekMail anmelden

Zugriff auf Ihr Dashboard, Ihre Postfächer und DNS.

12 Zeichen

E-Mail zum Zurücksetzen gesendet

Falls für diese E-Mail-Adresse ein Konto existiert, haben wir Anweisungen zum Zurücksetzen des Passworts gesendet.

Indem Sie fortfahren, stimmen Sie den Nutzungsbedingungen und der Datenschutzrichtlinie von TrekMail zu.