Product
Mailgun-API 2.0: Vergessen Sie MIME
Dieser Beitrag wurde ursprünglich am 18. Oktober 2011 veröffentlicht
Gute Nachrichten allerseits!
Das Team von Mailgun war im Labor, die Tastaturen in den Händen, um etwas Code auf die Beine zu stellen – und jetzt ist Mailgun 2.0 verfügbar. Heute starten wir eine kurze Serie von Blog-Beiträgen, in denen wir Ihnen von all den spannenden Funktionen erzählen, die wir entwickelt haben. Wenn Sie es nicht erwarten können, lesen Sie einfach unsere Dokumentation über all die Neuheiten in der neuen Version.
Wir möchten mit den folgenden Worten beginnen: „SCHLUSS MIT MIME“
Richtig gelesen, Sie müssen sich nicht mehr mit dem MIME-Format für E-Mail-Nachrichten befassen, um funktionsreiche Nachrichten mit HTML-Inhalten, Anhängen und Ähnlichem zu übermitteln.
Die bittere Wahrheit ist, dass nicht alle Programmiersprachen mit benutzerfreundlichen, gut dokumentierten und fehlerfreien MIME-Bibliotheken gesegnet sind. Dennoch weiß heutzutage fast jede Person, wie man eine HTTP-POST-Anfrage stellt, was ironisch ist, da die zugrunde liegenden Datenformate gleich sind.
Ein weiterer Trend, den wir festgestellt haben, ist, dass viele Personen aus der Programmierung keine Fachleute für E-Mails sind … und warum sollten sie das auch sein? Zum Beispiel wurden wir schon oft gefragt, wie man die „Bcc“-Funktion implementiert oder wie man eine Datei an eine Nachricht anhängt.
Mit dem Ziel, die beste E-Mail-Plattform auf dem Markt zu sein, haben wir beschlossen, uns genauer anzusehen, wie E-Mail-Nachrichten erstellt und versendet werden. Wir verlangen von unserem Entwicklungsteam nicht länger, Wikipedia-Artikel über mehrteilige E-Mails zu lesen und sich mit MIME-Bibliotheken von fragwürdiger Qualität herumzuschlagen.
Die neue API von Mailgun für den Versand von Nachrichten ist einfach. Übermitteln Sie uns Parameter per HTTP und wir erstellen MIME und versenden Ihre Nachricht. Welche Parameter? Diejenigen, die Sie erwarten würden: „From“, „To“, „Cc“, „Bcc“, „Subject“, „HTML body“, „attachment file“. Sie verstehen, was gemeint ist – dieselben Funktionen, die auch die Gmail-Benutzeroberfläche bietet.
Das bedeutet, dass Sie komplexe E-Mails mit dem guten alten curl versenden … oder sogar mit browserbasiertem JavaScript. Natürlich steht es den Fans der alten Schule weiterhin frei, eigenes MIME mit SMTP zu verwenden oder MIME über HTTP zu übermitteln: Wir sind vollständig abwärtskompatibel.
Genug geredet, sehen wir uns etwas Code an. Die meisten Programmiersprachen bieten integrierten Support für HTTP-Anfragen, aber für noch mehr Komfort empfehlen wir restclient für Ruby oder Anfragen für Python.
Um zu beginnen, versenden wir eine einfache Textnachricht:
curl --user api:key https://api.mailgun.net/v2/farfaraway.uk/messages -F from='Shrek ' -F to='Fiona ' -F subject='Status update' -F text='The cat is off the hook'
Wie wäre es mit einer mehrteiligen Nachricht mit Text- und HTML-Teilen, mehreren Empfangsadressen und einigen Anhängen, die auch an eine Bcc-Adresse geht? So einfach kann es sein:
curl --user api:key https://api.mailgun.net/v2/farfaraway.uk/messages -F from='Shrek ' -F to='Fiona ' -F bcc='Donkey ' -F subject='Status update' -F text='The cat is off the hook' -F html='The cat is off the hook!' -F attachment=@kitchen-photo.jpg
Alle, die benutzerdefinierte MIME-Kopfzeilen festlegen möchten, haben weiterhin die Möglichkeit dazu, ohne jemals mit MIME in Berührung zu kommen. Wenn ein POST-Parameter mit dem Präfix „h:“ beginnt, erkennt Mailgun ihn als benutzerdefinierte MIME-Kopfzeile. Hier ist ein Beispiel für den Versand einer Nachricht mit einer benutzerdefinierten Message-Id-Kopfzeile:
curl --user api:key https://api.mailgun.net/v2/farfaraway.uk/messages -F from='Shrek ' -F to='Fiona ' -F subject='Status update' -F text='The cat is off the hook' -F h:Message-Id='mycustomid-1231@farfaraway.uk'
Da haben Sie es: ein sauberer und einfacher Weg, das MIME-Chaos zu vermeiden. Weitere API-Tricks finden Sie über den unten stehenden Link zur Dokumentation. Einige weitere großartige Tricks, die sich integrieren lassen Versand im Testmodus oder Planung für eine bestimmte Zustellungszeit.
Überzeugen Sie sich selbst: https://documentation.mailgun.com/en/latest/user_manual.html#sending-via-api
Viele Grüße – Das Team von Mailgun
