Die Zustellung von JSON-Nutzdaten für Route-Weiterleitungen ist jetzt für alle Mailgun-Konten verfügbar
Viele Kunden nutzen Mailgun Routes, um eingehende E-Mails in Systeme zu integrieren, die auf JSON basieren – von Support-Plattformen bis hin zu benutzerdefinierten Anwendungen. Bisher wurde jede Route-Benachrichtigung als formularcodierte Daten zugestellt. Teams, deren Endpunkte für JSON entwickelt wurden, mussten daher einen zusätzlichen Konvertierungsschritt – wie etwa einen Middleware-Dienst – einführen, bevor diese Daten ihr System erreichen konnten. Mailgun Routes unterstützen JSON-Nutzdaten jetzt nativ. Fügen Sie json an das Ende der Ziel-URL einer Route an. Mailgun stellt die geparste Nachricht dann direkt als application/json zu – sodass Ihr Endpunkt sie beim Eintreffen sofort nutzen kann.
Welche Vorteile bietet Ihnen das?
Die native JSON-Zustellung bietet Ihrem Team mehr Flexibilität bei der Einbindung von Routes in Ihre bestehenden Systeme, während jede aktuelle Integration weiterhin genau so funktioniert wie heute.
- Senden Sie Route-Benachrichtigungen direkt an JSON-basierte Systeme. Wenn Ihre Ziel-URL auf json endet, stellt Mailgun die geparste Nachricht als application/json in dem Format zu, das Ihr Endpunkt erwartet.
- Führen Sie das neue Format in Ihrem eigenen Tempo ein. Die JSON-Zustellung wird pro Route konfiguriert. So können Sie einzelne Integrationen dann umstellen, wenn es für Ihr Team am besten passt, ohne dass das Verhalten anderer Routes beeinträchtigt wird.
- Behalten Sie jede bestehende Integration genau so bei, wie sie ist. Routes, die das Suffix json nicht enthalten, empfangen weiterhin application/x-www-form-urlencoded, genau wie bisher.
- Bauen Sie auf einer vertrauten Nutzdatenstruktur auf. Die JSON-Nutzdaten verwenden dieselben Feldnamen wie die formularbasierten Nutzdaten. Daher bedeutet die Anpassung einer bestehenden Integration in der Regel nur die Aktualisierung eines Parsers und nicht dessen Neuaufbau.
Was Sie tun müssen
Um das neue Format zu empfangen, hängen Sie json an das Ende der Ziel-URL Ihrer Route an. Die JSON-Nutzdaten unterscheiden sich in einigen Punkten von den formularbasierten Nutzdaten: Die Signatur-Verifizierung erfolgt über die Kopfzeilen X-Mailgun-Signature, X-Mailgun-Parent-Signature und X-Mailgun-Timestamp anstelle von Formularfeldern. message-headers wird als natives JSON-Array zugestellt. Anhänge werden in einem einzigen attachments-Array zusammengefasst, wobei jeder Eintrag filename, content-type und Base64-kodierten Inhalt bereitstellt. Routes, die das Suffix json nicht enthalten, sind davon nicht betroffen und empfangen weiterhin das bestehende Format.
