Guide des opérations

La requête API a expiré : la boîte a-t-elle été créée ?

Par Alexey Bulygin
Une loupe devant une boîte aux lettres verte près d’un sablier

Un délai dépassé ne dit pas si la création a échoué. Votre système doit relier la demande du client à la boîte obtenue. Séparez création, transfert et disponibilité : une coupure ne doit pas pousser à cliquer de nouveau sur Créer sans connaître le résultat.

Un programme peut créer des boîtes et configurer des redirections avec l'API TrekMail. L'API permet à votre système d'envoyer des commandes au service au lieu de demander à quelqu'un de les répéter dans le panneau. Ces modifications nécessitent Pro ou Agency, les droits adaptés et l'accès au domaine choisi.

Précisez ce que vous voulez créer

Décrivez d'abord le besoin simplement. « Le salarié a besoin d'une boîte personnelle » et « les messages de cette adresse doivent aller ailleurs » demandent des réglages différents.

Une boîte complète conserve ses propres échanges. Vous pouvez y configurer un transfert et décider si une copie locale doit rester. Une adresse de redirection sans boîte répond à un autre besoin : recevoir à une adresse et transmettre ailleurs sans y conserver d'archives propres. Les conditions et les limites de ces deux ressources diffèrent.

Distinguez aussi l'administration de la messagerie et l'accès au contenu. Créer une adresse ne nécessite pas de lire les échanges des salariés. Les messages relèvent d'autres possibilités de l'API. N'accordez pas cet accès à un programme qui crée seulement des boîtes.

Consignez ces distinctions avant le développement. Le spécialiste saura quelle ressource créer et quel résultat vous souhaitez voir dans le panneau.

Préparez l'offre et un accès limité

Pouvoir configurer une fonction manuellement ne signifie pas toujours pouvoir la modifier par API. La création de boîtes et la modification des transferts demandent Pro ou Agency. Starter permet de lire la configuration d'infrastructure accessible, ce qui ne suffit pas à cette automatisation.

Créez un accès propre au programme. Limitez-le aux actions et aux domaines nécessaires. Dans une agence, un programme dédié à un client doit intervenir uniquement sur les ressources de celui-ci.

Les droits de la personne qui accorde l'accès comptent aussi. Elle ne peut pas transmettre plus de pouvoirs qu'elle n'en possède. Le guide des autorisations API précise les droits et les conditions d'offre.

Conservez la clé d'accès dans la configuration côté serveur de l'intégration. Elle n'a pas à apparaître dans un formulaire client ni dans un message de bienvenue. L'utilisateur doit simplement obtenir son adresse créée et le moyen prévu pour commencer.

Organisez les étapes de création

Déterminez le domaine autorisé à partir de vos données client. Un identifiant fourni par le navigateur ne prouve pas son appartenance.

Vérifiez ensuite si l'adresse existe et si les limites disponibles permettent la création. Si une boîte est déjà présente, déterminez si elle correspond à la même demande. Un second clic de l'utilisateur ne doit pas laisser un état ambigu.

Après la création, configurez le transfert s'il est nécessaire. Pour une boîte complète, décidez à l'avance de la conservation d'une copie locale. Si le salarié compte y garder ses archives, ce choix ne doit pas dépendre d'une valeur laissée au hasard.

Si la boîte existe mais que le transfert a échoué, notez le résultat partiel et réparez cette étape. Déclarez la tâche prête après vérification de la livraison et de la copie locale.

La présentation de l'API TrekMail décrit les méthodes et les formats. Elle sert de spécification au développeur pendant que le parcours utilisateur reste simple.

Prévoyez les reprises et les erreurs

Pour une opération documentée comme idempotente, gardez la même Idempotency-Key pour la même demande et les mêmes données. Enregistrez l’ID retourné et vérifiez le contrat des autres opérations.

Dans les autres cas, l'intégration doit d'abord rechercher la ressource attendue. Ne répétez pas une création après toute réponse incomprise. Conservez le lien entre la demande et son résultat pour reprendre à la bonne étape.

Traitez séparément le manque de place, une limite atteinte et un refus d'accès. Répéter la même requête ne corrigera pas ces causes. Une explication claire et un responsable identifié sont plus utiles qu'un message « Création en cours » sans fin.

Pour un groupe de clients ou de salariés, ne promettez pas une durée identique pour toutes les demandes. Affichez l'état de chacune et les cas qui nécessitent une intervention.

Testez sur un seul domaine

Commencez avec un domaine de test et quelques adresses. Vérifiez une création normale, la répétition de la même demande et une tentative sur un domaine hors du périmètre autorisé.

Envoyez ensuite un message à l'adresse créée. En présence d'un transfert, vérifiez le destinataire final et la copie locale selon le mode choisi. Une réponse API réussie ne remplace pas le test du fonctionnement mail.

Avant le lancement, décidez qui recevra les erreurs et pourra intervenir manuellement. Gardez un journal des demandes sans clés secrètes ni mots de passe. Une fois ce petit processus fiable, vous pourrez l'intégrer à l'arrivée des salariés ou des clients.

Utilisez la référence API. Créer l’infrastructure ne demande pas de lire les messages du nouvel utilisateur ; limitez les permissions à ce travail.

À lire aussi

Partager cet article

Se connecter à TrekMail

Accédez à votre tableau de bord, vos boîtes et vos DNS.

12 caractères

E-mail de réinitialisation envoyé

Si un compte existe pour cette adresse, nous venons d’envoyer les instructions de réinitialisation du mot de passe.

En continuant, vous acceptez les Conditions d’utilisation et la Politique de confidentialité de TrekMail.