E-Mails empfangen

E-Mails mit der API lesen

Lesen Sie die E-Mails, die auf Ihrer Domain ankommen, aus Ihrem eigenen Code. Konversationen auflisten, Nachrichten öffnen, suchen, labeln, organisieren, senden und antworten, alles über einen einzigen Endpoint.

  • REST
  • JSON
  • Threads und Suche
  • Labels und Ordner
  • Senden und antworten
Hosthttps://g.sendcorex.com

So funktioniert es

Ein Token, ein Postfach

Ihr Token gehört zu einem Absender, und ein Absender ist ein Postfach. Kein Argument bestimmt, wessen E-Mails Sie lesen: Das entscheidet der Token.

Ein Endpoint für alles

Auflisten, lesen, suchen, markieren, verschieben, senden und antworten sind Befehle, die an POST /v1 gesendet werden. Bis zu 20 pro Anfrage.

Kurzlebige Tokens

Der Access Token gilt 1 Stunde, der Refresh Token 15 Tage. Der Refresh Token wird bei jeder Verwendung erneuert.

Postfach einrichten

Einmal erledigen. Danach braucht jede Anfrage nur noch Ihren Token.

  1. 1

    Domain hinzufügen oder eine gemeinsame nutzen

    Verifizieren Sie Ihre eigene Domain oder sparen Sie sich die DNS-Arbeit und nutzen Sie eine gemeinsame Domain.

  2. 2

    Absender erstellen

    Ein Absender ist ein Postfach. Erstellen Sie einen auf Ihrer verifizierten Domain oder auf einer gemeinsamen Domain: Auf einer gemeinsamen Domain wird mit dem Absender auch das Postfach erstellt.

    Wenn Sie Ihre eigene Domain registriert und bereits eine E-Mail gesendet haben, wurde der Absender automatisch für Sie erstellt.

  3. 3

    MX-Eintrag setzen

    Nur nötig, wenn Sie E-Mails auf Ihrer eigenen Domain empfangen möchten. Lassen Sie den MX-Eintrag auf den Inbound-Host von Sendcorex zeigen.

  4. 4

    Tokens erzeugen

    Öffnen Sie das Webmail, gehen Sie zu Einstellungen und erzeugen Sie einen Access Token und einen Refresh Token für den Absender.

  5. 5

    API aufrufen

    Senden Sie Ihren Token im Authorization-Header und Ihren ersten Befehl an POST /v1.

MX-Eintrag

Um E-Mails auf Ihrer eigenen Domain zu empfangen, muss deren MX-Eintrag auf den Inbound-Host von Sendcorex zeigen. Fügen Sie diesen Eintrag bei Ihrem DNS-Anbieter hinzu.

  • TypMX
  • Zeigt aufbounce.emailsbit.com
i

Der MX-Eintrag dient nur dem Empfang auf Ihrer eigenen Domain. Ohne ihn können Sie trotzdem senden und die Bounces und Beschwerden lesen, die in Ihr Postfach zurückkommen.

Was im Postfach ankommt

Normale E-Mails

Alles, was an Ihre Absenderadresse gesendet wird, wie in jedem Postfach.

Return-Path-Nachrichten

Bounces und andere Nachrichten, die an den Return-Path zurückkommen, werden ebenfalls im Postfach gespeichert, sodass Sie sie über die API lesen können.

Beschwerden

Spam-Beschwerden werden ebenfalls im Postfach gespeichert. Sie kommen nur von Microsoft 365 und Microsoft-Diensten allgemein.

Ihre erste Anfrage

Listen Sie die ungelesenen Konversationen in Ihrer INBOX auf. Ersetzen Sie SENDCOREX_TOKEN durch den Access Token aus den Webmail-Einstellungen.

curl -X POST 'https://g.sendcorex.com/v1' \
  -H "Authorization: $SENDCOREX_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
  "commands": [
    { "command": "list_threads", "args": { "folder": "INBOX", "is_read": false, "limit": 10 } }
  ]
}'

Jeder Thread hat eine last_message_uid. Übergeben Sie sie an Nachrichten abrufen, um die E-Mail zu lesen, oder an Antworten, um sie zu beantworten.

Vollständige Referenz

Alles mit CMD ist ein Befehl, der über POST /v1 gesendet wird, bis zu 20 pro Anfrage. Routen haben eigene Pfade.

Routen

4

Identität

1

Ordner und Zähler

5

Lesen

5

Flags und Labels

8

Organisieren

4

Senden und Vertrauen

9

Anhänge

4

Planen

3

Entwürfe

5

Regeln

10

Templates

6

Kontakt und Follow-up

5

Kontakte und Zielgruppe

12

Newsletter

4