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 & 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 öffnenE-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 öffnenMail & Graph
Senden und verwalten
Ein Schlüssel von der Seite Developer funktioniert auf mail.sendcorex.com und graph.sendcorex.com.
- 1
Seite Developer öffnen
Melden Sie sich auf app.sendcorex.com an und öffnen Sie die Seite Developer im Dashboard.
Seite Developer öffnen - 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
Mit jeder Anfrage senden
Übergeben Sie ihn im Authorization-Header auf mail.sendcorex.com und graph.sendcorex.com.
Authorization: Bearer YOUR_API_KEYE-Mails lesen
Ein Postfach lesen
Diese Schlüssel werden in Webmail erstellt, einer pro E-Mail-Konto, und auf g.sendcorex.com verwendet.
- 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
Einstellungen öffnen
Öffnen Sie den Bereich Einstellungen dieses E-Mail-Kontos.
- 3
Schlüssel erzeugen
Erstellen Sie dort den API-Schlüssel und kopieren Sie ihn. Jedes E-Mail-Konto hat seinen eigenen.
curl -s https://g.sendcorex.com/v1 \
-H "Authorization: $TOKEN" \
-H "Content-Type: application/json" \
-d '{"commands":[{"command":"list_folders"}]}'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.
| Code | HTTP | Wann |
|---|---|---|
MISSING_AUTH_HEADER | 401 | Die Anfrage hat keinen Authorization-Header. |
INVALID_TOKEN | 401 | Falsches Format, unbekannter oder widerrufener Token. |
TOKEN_EXPIRED | 401 | Der Token ist abgelaufen. Verwenden Sie den Refresh-Token. |
RATE_LIMITED | 429 | Mehr als 15 Anfragen pro Sekunde oder 15 gleichzeitig offen. |
AUTH_UNAVAILABLE | 503 | Die Authentifizierung ist vorübergehend nicht verfügbar. |