Supressões
`suppressions->list`, `listAll`, `iterate`, `get`, `add` e `remove`.
Todos os 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']);}Os endereços para os quais este espaço de trabalho não envia: bounces permanentes e queixas, registados no momento em que acontecem, e qualquer endereço bloqueado à mão. Um envio para um deles é recusado para esse destinatário antes de sair o que quer que seja. Ler precisa de settings:read e alterar precisa de settings:write, os âmbitos que protegem o ecrã Endereços bloqueados. reason: mantém um único tipo, bounce, complaint ou manual, e OpenEmail\Constants\SuppressionReasons nomeia-os. q: pesquisa os endereços.
list devolve uma OpenEmail\Result\Page, das mais recentes para as mais antigas, listAll devolve todas as linhas num único array, e iterate devolve um Generator que entrega uma linha de cada vez. Uma linha é um array com id, email, reason, detail, removable e createdAt, e add aceita um único array com email.
add devolve a linha, quer seja nova quer já existisse, por isso repeti-lo é inofensivo e o cliente repete-o após uma falha de rede. remove recusa um bounce permanente com 409 suppression_not_removable, lançado como ConflictException, o que removable lhe diz de antemão. Uma chave limitada a determinados endereços ou domínios pode ler a lista mas não a pode alterar: add e remove respondem-lhe com um 422 capability_unsupported.