Sperrliste

Was gesperrt wird

Ein harter Bounce oder eine Beschwerde setzt die Adresse des Empfängers auf die Sperrliste Ihres Kontos. letr.dev versendet dann nicht mehr dorthin: Ein Versand mit einer gesperrten Adresse ergibt 422 recipient_suppressed und nennt die Adressen. Das schützt Ihre Reputation und die gemeinsame Versandreputation aller Konten.

Jeder Eintrag hat die email, einen reason (bounced, complained oder manual) und den Zeitpunkt.

Anzeigen und entfernen

curl https://api.letr.dev/v1/suppressions \
  -H "Authorization: Bearer $LETR_API_KEY"

curl -X DELETE https://api.letr.dev/v1/suppressions/[email protected] \
  -H "Authorization: Bearer $LETR_API_KEY"

Die Liste beginnt mit dem neusten Eintrag, 50 Einträge pro Seite (limit bis 100). Für die nächste Seite übergeben Sie das nextCursor der Antwort als cursor; auf der letzten Seite ist es null. q findet die Einträge, deren Adresse es enthält (3 bis 200 Zeichen). Anzeigen braucht read_only oder full_access, Entfernen full_access; ein Key mit sending_access erhält 403 insufficient_permission. Eine Adresse, die nicht auf der Liste steht, ergibt 404 not_found. Das Dashboard kann beides, und die API-Referenz nennt alle Felder. Entfernen Sie eine Adresse nur, wenn der Grund weg ist, zum Beispiel ein Postfach, das wieder existiert. Ein weiterer Bounce oder eine weitere Beschwerde setzt sie wieder auf die Liste.

Adresse hinzufügen

curl https://api.letr.dev/v1/suppressions \
  -H "Authorization: Bearer $LETR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email": "[email protected]"}'

Hinzufügen braucht full_access und setzt die Adresse mit dem Grund manual auf die Liste. Die Antwort ist 201 mit dem neuen Eintrag oder 200 mit dem bestehenden, wenn die Adresse schon auf der Liste steht. Eine ungültige Adresse ergibt 422 invalid_email.

Liste importieren

curl https://api.letr.dev/v1/suppressions/import \
  -H "Authorization: Bearer $LETR_API_KEY" \
  -H "Content-Type: text/csv" \
  --data-binary @suppressions.csv

Senden Sie eine Adresse pro Zeile, als CSV oder einfachen Text. Eine erste Zeile email gilt als Kopfzeile und wird übersprungen, und von einer CSV-Zeile zählt nur die erste Spalte. Ein Import umfasst höchstens 10'000 Zeilen und 1 MB; darüber lautet die Antwort 413 import_too_large. Importierte Adressen erhalten den Grund manual, und Adressen, die schon auf der Liste stehen, werden gezählt, nicht geändert. Importieren braucht full_access.

{ "added": 182, "alreadySuppressed": 4, "invalidCount": 1, "invalidLines": [57] }

invalidLines enthält die Zeilennummern (ab 1 gezählt) ohne gültige Adresse, höchstens die ersten 100.

Adresse eines Empfängers löschen

Verlangt ein Empfänger, dass seine Daten gelöscht werden, entfernen Sie seine Adresse aus letr.dev:

curl -X DELETE https://api.letr.dev/v1/recipients/[email protected] \
  -H "Authorization: Bearer $LETR_API_KEY"

Das ersetzt die Adresse durch erased in jeder E-Mail Ihres Kontos (to, cc, bcc), in deren Ereignissen und in den Webhook-Zustellungen, die sie nennen, und löscht ihren Eintrag in der Sperrliste. Der Inhalt jeder E-Mail an diese Adresse oder mit ihr im Betreff oder in den Tags wird sofort gelöscht. Eine geplante E-Mail, die die Adresse nur im Betreff oder in den Tags nennt, wird trotzdem zu ihrem Zeitpunkt versendet, und die Warteschlange von letr.dev behält sie bis dahin. Die E-Mails bleiben, ebenso ihre Zählung beim Verbrauch und bei den Bounce- und Beschwerderaten; die Löschung ändert also nie Ihre Limiten, Ihre Abrechnung oder Ihre Reputation. Mit ?keepSuppression=true bleibt der Eintrag, und letr.dev versendet weiterhin nicht an die Adresse. Die Antwort nennt, aus wie vielen E-Mails die Adresse entfernt wurde: { "emails": 3, "suppressionRemoved": true }. Dafür braucht es full_access, und es lässt sich nicht rückgängig machen.