Despacho y operaciones
poner en cola una carta
Reciba ID casilla de GET /v1/mailboxes. Cree un Idempotency-Key único para un envío y guárdelo hasta el resultado final. Para la reproducción en red, utilice la misma clave y el mismo cuerpo.
HTTP 202 devuelve un objeto de operación, no una confirmación de entrega. El campo id contiene ID operaciones. Encuesta 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"}Cómo entender el resultado.
queued- La carta está esperando ser enviada.
running- El envío está en curso.
succeeded- El servidor de correo aceptó el envío. Consulta el resultado de cada destinatario.
failed- El envío falló. El motivo se da en error.
cancelled- Envío cancelado.
uncertain- No se pudo confirmar el resultado del envío. Verifique la operación y su carpeta de enviados antes de volver a intentarlo.
Después de un envío exitoso, el campo result contiene accepted_recipients - destinatarios aceptados, rejected_recipients - destinatarios rechazados y sent_saved - el resultado de guardar una copia en enviado. La aceptación de una carta por parte de un servidor de correo no garantiza la entrega a la bandeja de entrada del destinatario.
Para cancelar un envío pendiente, ejecute POST /v1/operations/{operation_id}/cancel. El método /retry no reenvía el correo electrónico.
Respuesta, reenvío y envío retrasado
Para responder, incluya message_id del correo electrónico original en reply_to_message_id y reenvíelo a references.. En to, ingrese la dirección de respuesta de reply_to o la dirección del remitente. Para responder a todos, agregue otros participantes a to y cc, excluyendo su propia dirección.
Para reenviar archivos adjuntos, pase forward_message con folder, uidvalidity y uid.. Para sus archivos cargados, use file_ids. El tamaño total del archivo adjunto está limitado a 25 MiB.
send_at se especifica con una zona horaria, almacenada en UTC; El envío diferido está disponible dentro de un año. Los límites se verifican en el momento del envío real, no en el momento de la creación de la cola.