Expédition et opérations
Mettre une lettre en file d'attente
Recevez une boîte ID de GET /v1/mailboxes. Créez un Idempotency-Key unique pour une soumission et enregistrez-le jusqu'au résultat final. Pour la relecture réseau, utilisez la même clé et le même corps.
HTTP 202 renvoie un objet d'opération, pas une confirmation de livraison. Le champ id contient ID opérations. Sondage 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"}Comment comprendre le résultat
queued- La lettre attend d'être envoyée.
running- L'envoi est en cours.
succeeded- Le serveur de messagerie a accepté la soumission. Vérifiez le résultat pour chaque destinataire.
failed- L'envoi a échoué. La raison est indiquée en error.
cancelled- Envoi annulé.
uncertain- Échec de la confirmation du résultat de l'envoi. Veuillez vérifier l'opération et votre dossier envoyé avant de réessayer.
Après un envoi réussi, le champ result contient accepted_recipients - destinataires acceptés, rejected_recipients - destinataires rejetés et sent_saved - le résultat de l'enregistrement d'une copie dans l'envoi. L'acceptation d'une lettre par un serveur de messagerie ne garantit pas sa livraison dans la boîte de réception du destinataire.
Pour annuler un envoi en attente, exécutez POST /v1/operations/{operation_id}/cancel. La méthode /retry ne renvoie pas l'e-mail.
Réponse, transfert et expédition différée
Pour répondre, veuillez inclure message_id de l'e-mail d'origine dans reply_to_message_id et le transférer à references. Dans to, entrez l'adresse de réponse de reply_to ou l'adresse de l'expéditeur. Pour répondre à tout le monde, ajoutez les autres participants à to et cc, en excluant votre propre adresse.
Pour transférer des pièces jointes, transmettez forward_message avec folder, uidvalidity et uid.. Pour vos fichiers téléchargés, utilisez file_ids. La taille totale des pièces jointes est limitée à 25 Mio.
send_at est spécifié avec un fuseau horaire, stocké dans UTC ; l’expédition différée est disponible dans un délai d’un an. Les limites sont vérifiées lors de l'envoi réel, et non lors de la création de la file d'attente.