technique · réponse sourcée
Qu’est-ce que le sandbox mode de SendGrid ?
Le sandbox mode de SendGrid est un environnement restreint qui permet aux développeurs de tester leurs intégrations API et leurs configurations SMTP sans envoyer d’e-mails à de vrais destinataires. Dans ce mode, le système valide la requête et renvoie une réponse de succès, mais l’e-mail n’est pas réellement délivré à l’adresse de destination, afin d’éviter tout spam accidentel ou usage abusif pendant le développement.
Fonctionnement du sandbox mode
Lorsqu’un compte est en sandbox mode, SendGrid traite l’appel API ou la requête SMTP entrante pour vérifier que le payload est syntaxiquement correct et que l’authentification est valide. L’API renvoie un code de statut 202 Accepted, qui indique que la requête a été reçue. En revanche, l’agent de transfert de courrier ne relaie pas le message vers l’internet externe. Les développeurs peuvent ainsi vérifier la logique de leur code et leur gestion des erreurs sans mettre en jeu leur réputation d’expéditeur ni engager de frais.
Exigences de vérification
Pour sortir du sandbox mode, les utilisateurs doivent effectuer une procédure de vérification. Celle-ci consiste généralement à fournir les informations du compte et à vérifier une identité d’expéditeur. SendGrid impose cette étape pour limiter le risque que la plateforme soit utilisée à des fins malveillantes. Tant que le compte n’est pas entièrement approuvé, toute tentative d’envoi vers des adresses non vérifiées aboutit à l’abandon du message, même si l’API renvoie une réponse de succès.
Stratégies de test
Les développeurs devraient utiliser le sandbox mode pour tester l’intégration de leur application avec l’API SendGrid. Une fois les réponses de l’API confirmées, l’étape suivante consiste à vérifier une adresse d’expéditeur unique ou un domaine complet. Les outils gratuits de SendHQ peuvent aider les développeurs à s’assurer que leurs enregistrements DNS sont correctement configurés avant le passage en production, afin d’éviter les échecs de livraison.
Passer en production
Le passage en production nécessite de terminer la procédure d’activation du compte et de configurer l’authentification du domaine. Il faut pour cela ajouter des enregistrements SPF et DKIM aux paramètres DNS du domaine d’envoi. Une fois que le statut du compte passe de sandbox à actif, les e-mails sont acheminés vers les vrais destinataires. Les développeurs devraient effectuer un dernier test avec une adresse interne connue avant de lancer l’envoi à toute une liste d’utilisateurs.
Les questions que posent les équipes
Pourquoi est-ce que je reçois une réponse 202 mais aucun e-mail ?
C’est le comportement attendu du sandbox mode. Le statut 202 signifie que la requête API était valide, mais que l’e-mail n’a pas été délivré, car le compte est toujours restreint.
Comment désactiver le sandbox mode ?
Vous devez terminer la procédure de vérification du compte et fournir à l’équipe SendGrid les informations professionnelles demandées pour approbation.
Puis-je envoyer à ma propre adresse en sandbox mode ?
En général, non. Sauf si l’adresse e-mail est spécifiquement vérifiée comme expéditeur ou fait partie d’une identité vérifiée, le sandbox mode bloque la livraison vers toutes les adresses.
Le sandbox mode est-il payant ?
Non, les requêtes effectuées en sandbox mode ne sont pas décomptées de votre quota d’envoi mensuel, puisqu’aucun e-mail n’est réellement délivré.
Sources primaires
- Documentation SendGrid — Twilio SendGrid
- Tarifs SendGrid — Twilio SendGrid