Standard-API-Version jetzt V3

Dies wurde ursprünglich am 23. März 2015 angekündigt.

Wir haben kürzlich einige Leistungs- und Stabilitätsverbesserungen an unserer API vorgenommen. Aufgrund der Tragweite der Änderungen und um unsere API einheitlich zu halten, ändern wir die Standard-Basis-URL auf /v3.

https://api.mailgun.net/v3/

Sie müssen Ihre Endpunkte nicht ändern. Alle bestehenden API-Methoden bleiben abwärtskompatibel und behalten das gleiche Request-/Response-Format bei. Bei einigen wenigen wird es jedoch Verhaltensänderungen geben.

Wir haben wesentliche Änderungen an unserer Suppressions-API vorgenommen, die Ihre Bounces, Abmeldungen und Beschwerden verwaltet.

Alles, was unten für „Bounces“ erwähnt wird, gilt auch für „Abmeldungen“ und „Beschwerden“.

• Die aktuelle Methode GET /v2//bounces behält das gleiche Request-/Response-Format bei, wird aber faktisch zu einem Alias für die Events API, sodass sie nur Bounces zurückgeben kann, die in den letzten 30 Tagen aufgetreten sind. Aufgrund der Funktionsweise der Events API ist die über diesen API-Aufruf zurückgegebene total_count nicht mehr genau und wird nur aus Gründen der Abwärtskompatibilität beibehalten.

• Die neue Methode GET /v3//bounces zum Iterieren über alle Bounces der Domain gibt Bounce-Adressen in alphabetischer Reihenfolge zurück, sodass sie nicht mehr zum Abrufen der neuesten Bounces verwendet werden kann. Sie ist außerdem deutlich schneller und stabiler als ihr /v2-Pendant, wenn über große Listen iteriert wird.
• Mit der neuen Batch-Upload-Methode können Sie viele Bounces in einem einzigen API-Aufruf hochladen.
• Anpassungen an den Request-/Response-Formaten anderer Methoden der Suppressions-API, die allgemein für eine sauberere API sorgen.

Neue Dokumentation zur Suppressions-API finden Sie hier.

Wenn Sie derzeit die API /v2//bounces verwenden, um die neuesten Bounces abzurufen, können Sie diese weiterhin nutzen, sollten sich aber nicht auf total_count verlassen. Wenn Sie jedoch zuverlässig alle Bounces einer Domain abrufen möchten, verwenden Sie bitte den API-Aufruf /v3//bounces.

Der Großteil unserer Kundschaft sollte von diesen Änderungen nicht betroffen sein. Vielmehr sollten Sie ein Leistungs-Upgrade bei unseren APIs bemerken. Falls Sie doch davon betroffen sind, können Sie jederzeit gerne unser Support-Team kontaktieren , wenn Sie Fragen haben.

Viel Spaß beim Versenden.

Autor: The Sinch Mailgun team The Sinch Mailgun team shares news, best practices, and strategies to take your products and apps to the next level using email. Subscribe to our newsletter to get all the articles in your inbox!