Erste Schritte

API-Schlüssel erstellen

Senden und Verwalten nutzen einen Schlüssel. Das Lesen von E-Mails nutzt einen anderen, der an anderer Stelle erstellt wird. Wählen Sie den, der zu Ihrem Vorhaben passt.

Welchen Schlüssel brauchen Sie?

mail.sendcorex.comgraph.sendcorex.com

Mail & Graph

Senden und verwalten

Zum Senden von E-Mails und für alles andere in der API: Domains, Kontakte, Tracking, Absender und Logs.

Erstellt in

Dashboard, Seite Developer

Seite Developer öffnen
g.sendcorex.comEiner pro Konto

E-Mails lesen

Ein Postfach lesen

Zum Lesen, Durchsuchen und Organisieren der E-Mails eines E-Mail-Kontos.

Erstellt in

Webmail, Einstellungen jedes E-Mail-Kontos

Webmail öffnen

Mail & Graph

Senden und verwalten

Ein Schlüssel von der Seite Developer funktioniert auf mail.sendcorex.com und graph.sendcorex.com.

  1. 1

    Seite Developer öffnen

    Melden Sie sich auf app.sendcorex.com an und öffnen Sie die Seite Developer im Dashboard.

    Seite Developer öffnen
  2. 2

    Schlüssel erstellen

    Erzeugen Sie dort einen neuen Schlüssel und kopieren Sie ihn. Bewahren Sie ihn sicher auf.

    API-Schlüssel erstellen
  3. 3

    Mit jeder Anfrage senden

    Übergeben Sie ihn im Authorization-Header auf mail.sendcorex.com und graph.sendcorex.com.

Request-Header
Authorization: Bearer YOUR_API_KEY

E-Mails lesen

Ein Postfach lesen

Diese Schlüssel werden in Webmail erstellt, einer pro E-Mail-Konto, und auf g.sendcorex.com verwendet.

  1. 1

    Webmail öffnen

    Öffnen Sie webmail.sendcorex.com und melden Sie sich mit dem E-Mail-Konto an, das Sie lesen möchten.

    Webmail öffnen
  2. 2

    Einstellungen öffnen

    Öffnen Sie den Bereich Einstellungen dieses E-Mail-Kontos.

  3. 3

    Schlüssel erzeugen

    Erstellen Sie dort den API-Schlüssel und kopieren Sie ihn. Jedes E-Mail-Konto hat seinen eigenen.

Erste Anfrage
curl -s https://g.sendcorex.com/v1 \
  -H "Authorization: $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"commands":[{"command":"list_folders"}]}'
Token erneuern
curl -s https://g.sendcorex.com/v1/token/refresh \
  -H "Content-Type: application/json" \
  -d "{\"refresh_token\":\"$REFRESH\"}"

Senden Sie den Token als Authorization: <token> oder Authorization: Bearer <token>. Tokens beginnen mit S.C.G. und der Refresh-Token mit R.S.C.G.

Ein Postfach pro Schlüssel

Der Schlüssel bestimmt, wessen E-Mails Sie lesen. Kein Argument in einer Anfrage kann einen anderen Besitzer wählen.

Tokens laufen ab

Ein abgelaufener Token liefert TOKEN_EXPIRED. Erneuern Sie das Paar mit Refresh Token. Der verwendete Refresh-Token funktioniert sofort nicht mehr.

Widerrufene Schlüssel

Ein Token wird bis zu 1 Stunde zwischengespeichert, daher kann ein widerrufener Token weiter funktionieren, bis dieser Cache abläuft.

Rate Limit

15 Anfragen pro Sekunde und 15 gleichzeitig, pro IP und Postfach. Darüber erhalten Sie 429 RATE_LIMITED mit einem Retry-After-Header.

Authentifizierungsfehler

Was die API zum Lesen von E-Mails zurückgibt, wenn der Schlüssel das Problem ist.

CodeHTTPWann
MISSING_AUTH_HEADER401Die Anfrage hat keinen Authorization-Header.
INVALID_TOKEN401Falsches Format, unbekannter oder widerrufener Token.
TOKEN_EXPIRED401Der Token ist abgelaufen. Verwenden Sie den Refresh-Token.
RATE_LIMITED429Mehr als 15 Anfragen pro Sekunde oder 15 gleichzeitig offen.
AUTH_UNAVAILABLE503Die Authentifizierung ist vorübergehend nicht verfügbar.