Use smtp4dev API for automate SMTP Email Server Testing
Zusammenfassung
Kurz
Der vollständige Bericht erläutert anhand von Beispielen, wie sich smtp4dev über seine API konfigurieren lässt und wie Tests Postfächer, Nachrichten und Nachrichtenteile abrufen können. Der Autor erklärt, dass `/Messages/new` nicht zwingend nur ungelesene E-Mails liefert; seine Vermutung zur Bedeutung des Endpunkts bleibt ausdrücklich eine Vermutung.
Mittel
Der vollständige Bericht beschreibt, wie die smtp4dev-API zum automatisierten Testen von E-Mail-Funktionen eingesetzt werden kann. Vorausgesetzt wird, dass der lokale Testserver bereits läuft. Weil die OpenAPI-Dokumentation nach Einschätzung des Autors wenig erklärt, führt er wichtige Endpunkte anhand von Beispielen vor.
Zur Konfiguration empfiehlt er, mit `GET /api/Server` die vorhandenen Einstellungen abzurufen und sie als Vorlage für `POST /api/Server` zu verwenden. So könne man etwa ein Postfach ergänzen und übrige Werte beibehalten. Postfächer lassen sich auch über `GET /api/Mailboxes` auflisten.
Nachrichten eines Postfachs können über `GET /api/Messages` oder `GET /api/Messages/new` abgefragt werden. `/new` bedeutet laut Autor nicht, dass nur ungelesene Nachrichten zurückkommen; dafür müsse das Feld `isUnread` geprüft werden. Seine Erklärung, `/new` könne sich auf `lastSeenMessageId` beziehen, kennzeichnet er als Vermutung. Für den Nachrichteninhalt ruft man zunächst die Nachricht mit ihrer ID ab und anschließend jeden Teil über einen eigenen Endpunkt; dessen Antwort sei Klartext. Zum Zurücksetzen des Lesestatus nennt der Artikel Endpunkte zum Markieren aller Nachrichten eines Postfachs oder einer einzelnen Nachricht. Die Empfehlungen beruhen auf der Darstellung des Autors; systematische Testergebnisse werden nicht berichtet.
Ausführlich lesen
Der vollständige Bericht erklärt, wie sich die API des lokalen Testservers smtp4dev nutzen lässt, um E-Mail-Funktionen einer Anwendung automatisiert zu prüfen. Der Autor knüpft an einen früheren Beitrag zur Einrichtung des Fake-SMTP-Servers an und setzt voraus, dass smtp4dev bereits installiert ist und läuft. Er merkt an, dass die OpenAPI-Dokumentation unter `http://localhost:5000/api` zwar verfügbar sei, aber nach seiner Einschätzung nur wenig erkläre, was die einzelnen Endpunkte tun.
Für die Einrichtung von Benutzern und Postfächern empfiehlt der Autor, zunächst mit `GET /api/Server` die aktuellen Servereinstellungen abzurufen. Diese Antwort könne dann als Grundlage für `POST /api/Server` dienen: Man ändere nur die benötigten Werte und lasse den Rest auf den vorhandenen Einstellungen. Als Beispiel ergänzt der Bericht ein Postfach mit dem Namen und Empfänger `to@example.com`. Postfächer lassen sich laut Artikel außerdem über `GET /api/Mailboxes` auflisten; für das Abrufen ihrer Nachrichten sei der jeweilige Postfachname erforderlich, sofern nicht das Standardpostfach verwendet werde.
Zum Abrufen von E-Mails nennt der Autor zwei Endpunkte: `GET /api/Messages` und `GET /api/Messages/new`. Beide können mit dem Abfrageparameter `mailboxName` auf ein Postfach beschränkt werden. Entgegen einer möglichen Vermutung liefere `/new` laut Bericht nicht automatisch nur ungelesene Nachrichten. Den Status zeige vielmehr das Feld `isUnread`, das der testende Code selbst auswerten müsse. Die Erklärung des Namens „new“ kennzeichnet der Autor ausdrücklich als Vermutung: Möglicherweise beziehe er sich auf den Parameter `lastSeenMessageId`, mit dem Nachrichten bis einschließlich einer angegebenen ID ausgeschlossen werden können. `/Messages/new` empfiehlt der Artikel, wenn dieser Bezug zur letzten Nachricht genügt; `/Messages` sei geeigneter, wenn Sortierung oder Suchbegriffe gebraucht werden. Für den beschriebenen Zweck seien beide nach Einschätzung des Autors austauschbar.
Den Inhalt einer Nachricht ruft man dem Artikel zufolge in zwei Schritten ab. Zuerst liefert `GET /api/Messages/{id}` unter anderem Kopfzeilen und eine Liste der Nachrichtenteile. Danach wird für jeden Teil dessen ID verwendet, um über `GET /api/Messages/{id}/part/{part_id}/content` den jeweiligen Inhalt abzurufen. Der Bericht weist darauf hin, dass die Antwort dieses zweiten Aufrufs einfacher Text und kein JSON sei.
Für Tests, die ungelesene E-Mails verarbeiten, schlägt der Autor vor, vor dem Versand neue Nachrichten alle Nachrichten eines Postfachs als gelesen zu markieren. Nach dem Abruf eines Nachrichtentexts solle auch diese Nachricht als gelesen markiert werden. Dazu nennt er `POST /api/Messages/markAllRead` mit `mailboxName` sowie `POST /api/Messages/{id}/markRead`, für den laut Bericht kein Postfachname nötig ist.
Der Artikel bietet Beispiele für API-Aufrufe und Antworten, berichtet jedoch keine systematischen Testergebnisse oder einen unabhängigen Vergleich. Seine Angaben und Empfehlungen werden als Darstellung des Autors wiedergegeben; insbesondere die Erklärung von `/new` bleibt eine ausdrücklich gekennzeichnete Vermutung.
Gegengeprüft von Claude Haiku 5.5: kleine Mängel
Keine Fragen angegeben, daher keine Einordnung. Geprüft wurde die mittlere Zusammenfassung; die kurze Fassung ist inhaltlich ebenfalls korrekt. Kleiner Mangel in der mittleren Fassung: Die Endpunkte markAllRead und markRead setzen Nachrichten auf gelesen, sie setzen den Lesestatus aber nicht zurück. Die Formulierung „zurücksetzen“ ist daher ungenau.
Im Bericht, aber nicht in der Zusammenfassung
- Die Empfehlung, vor dem Senden alle Nachrichten als gelesen zu markieren und abgerufene Nachrichten danach einzeln als gelesen zu markieren
- Die Unterscheidung: /Messages/new eignet sich zum Filtern nach lastSeenMessageId, /Messages für Sortierung und Suche
Wie die Modelle den Bericht einordnen
Ansicht
Filter
Kein Modell sieht bei diesem Bericht einen Bezug zu einer der 44 Sammelfragen.