Supresiones
`suppressions->list`, `listAll`, `iterate`, `get`, `add` y `remove`.
Todos los métodos
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']);}Las direcciones a las que este espacio de trabajo no enviará: rebotes permanentes y quejas, registrados en cuanto ocurren, y cualquier dirección bloqueada a mano. Un envío a una de ellas se rechaza para ese destinatario antes de que salga nada. Leer necesita settings:read y cambiar necesita settings:write, los ámbitos que protegen la pantalla Direcciones bloqueadas. reason: conserva un solo tipo, bounce, complaint o manual, y OpenEmail\Constants\SuppressionReasons los nombra. q: busca en las direcciones.
list devuelve una OpenEmail\Result\Page, de la más reciente a la más antigua, listAll devuelve todas las filas en un solo array, e iterate devuelve un Generator que entrega una fila cada vez. Una fila es un array con id, email, reason, detail, removable y createdAt, y add acepta un solo array con email.
add devuelve la fila tanto si era nueva como si ya estaba, así que repetirlo no hace daño y el cliente lo reintenta tras un fallo de red. remove rechaza un rebote permanente con 409 suppression_not_removable, lanzado como una ConflictException, algo que removable te dice de antemano. Una clave limitada a direcciones o dominios concretos puede leer la lista y no puede cambiarla: add y remove le responden con un 422 capability_unsupported.