Sperrliste
`suppressions->list`, `listAll`, `iterate`, `get`, `add` und `remove`.
Jede Methode
use OpenEmail\Constants\SuppressionReasons; $complaints = $client->suppressions->listAll(reason: SuppressionReasons::COMPLAINT);echo implode(', ', array_column($complaints, 'email')), PHP_EOL; $row = $client->suppressions->add(['email' => '[email protected]']); if ($row['removable']) { $client->suppressions->remove($row['id']);}Die Adressen, an die dieser Workspace nicht sendet: Hard Bounces und Beschwerden, festgehalten, sobald sie passieren, und jede von Hand gesperrte Adresse. Ein Versand an eine davon wird für diesen Empfänger abgelehnt, bevor etwas hinausgeht. Lesen braucht settings:read und Ändern settings:write, die Scopes, hinter denen die Ansicht „Blockierte Adressen“ liegt. reason: behält eine Art, bounce, complaint oder manual, und OpenEmail\Constants\SuppressionReasons nennt sie. q: durchsucht die Adressen.
list gibt eine OpenEmail\Result\Page zurück, neueste zuerst, listAll gibt alle Zeilen in einem einzigen Array zurück, und iterate gibt einen Generator zurück, der eine Zeile nach der anderen liefert. Eine Zeile ist ein Array mit id, email, reason, detail, removable und createdAt, und add nimmt ein einzelnes Array mit email.
add gibt die Zeile zurück, ob sie neu war oder schon existierte. Eine Wiederholung ist daher harmlos, und der Client wiederholt den Aufruf nach einem Netzwerkfehler. remove lehnt einen Hard Bounce mit 409 suppression_not_removable ab, geworfen als ConflictException, was removable Ihnen vorher verrät. Ein auf bestimmte Adressen oder Domains beschränkter Schlüssel kann die Liste lesen, aber nicht ändern: add und remove antworten ihm mit einem 422 capability_unsupported.