Despacho e operações
Enfileirar uma carta
Caixa de recebimento ID de GET /v1/mailboxes. Crie um Idempotency-Key exclusivo para um envio e salve-o até o resultado final. Para reprodução em rede, use a mesma chave e o mesmo corpo.
HTTP 202 retorna um objeto de operação, não uma confirmação de entrega. O campo id contém operações ID. Enquete GET /v1/operations/{operation_id}.
POST /v1/mailboxes/42/sendIdempotency-Key: message-20261019-0001Content-Type: application/json
{"to":["[email protected]"],"subject":"Hello","text":"A message from Adapt Mail"}Como entender o resultado
queued- A carta está aguardando para ser enviada.
running- O envio está em andamento.
succeeded- O servidor de e-mail aceitou o envio. Verifique o resultado para cada destinatário.
failed- Falha no envio. O motivo é fornecido em error.
cancelled- Envio cancelado.
uncertain- Falha ao confirmar o resultado do envio. Verifique a operação e a pasta enviada antes de tentar novamente.
Após um envio bem-sucedido, o campo result contém accepted_recipients - destinatários aceitos, rejected_recipients - destinatários rejeitados e sent_saved - o resultado de salvar uma cópia enviada. A aceitação de uma carta por um servidor de correio não garante a entrega na caixa de entrada do destinatário.
Para cancelar um envio pendente, execute POST /v1/operations/{operation_id}/cancel. O método /retry não reenvia o email.
Resposta, encaminhamento e envio atrasado
Para responder, inclua message_id do e-mail original em reply_to_message_id e encaminhe para references.. Em to, insira o endereço de resposta de reply_to ou o endereço do remetente. Para responder a todos, adicione outros participantes a to e cc, excluindo o seu próprio endereço.
Para encaminhar anexos, passe forward_message com folder, uidvalidity e uid. Para seus arquivos enviados, use file_ids. O tamanho total do anexo é limitado a 25 MiB.
send_at é especificado com um fuso horário, armazenado em UTC; o envio diferido está disponível dentro de um ano. Os limites são verificados no envio real, não na criação da fila.