Logs de requêtes

Email API›Logs enregistre le trafic API et SMTP qui atteint Emailit avec vos clés API. Quand un envoi échoue avant même la création d’un e-mail, par exemple à cause d’une erreur de validation ou d’une limite de débit, c’est dans le log de requêtes que vous voyez ce que votre code a envoyé et exactement ce qu’Emailit a répondu.

Ce qui est enregistré

L’en-tête de la page le résume : « Successful and failed API v2 and SMTP requests authenticated with an API key. »

Ne sont pas enregistrés :

• Les requêtes sans clé API ou avec une clé inconnue, car elles ne peuvent pas être rattachées à un espace de travail. Si vous recevez 401 Invalid API key et ne voyez rien ici, vérifiez quelle clé utilise votre code.
• L’activité dans le tableau de bord, et les commandes SMTP AUTH réussies.

Les valeurs sensibles sont masquées avant le stockage. Les champs nommés comme password, secret, token, authorization ou api_key, et les valeurs qui ressemblent à des clés API (secret_…) ou à des jetons, sont remplacés par [redacted]. Les chaînes longues sont tronquées à 16 384 caractères et les tableaux à 50 éléments : les pièces jointes volumineuses n’apparaissent donc pas en entier.

Trouver une requête

• Période : choisissez Last 1 hour, Last 6 hours, Last 24 hours (par défaut), Last 72 hours, Last 7 days ou Last 30 days, ou choisissez une plage de dates personnalisée. Vous pouvez aussi faire glisser le curseur sur le graphique pour zoomer sur une période.
• Graphique : les requêtes réussies et en échec dans le temps, pour repérer le début des erreurs.
• Recherche : porte sur le chemin, le message, la méthode ou le statut.
• Filtres : Source (API ou SMTP), Outcome (Success ou Error), Method, Path, Message, Status code, Duration, Created et API key.

Le tableau affiche Timestamp, Level (Success pour les codes de statut inférieurs à 400, Error sinon), Source, Method, Message (par exemple POST /v2/emails → 422), Status et Duration.

Lire une requête

Sélectionnez une ligne pour l’ouvrir. La page affiche :

• Created, Level, Source et Status.
• Request body : le JSON envoyé par votre code, ou pour SMTP la commande, l’enveloppe et le résumé du message.
• Response body : ce qu’Emailit a renvoyé, y compris les détails de l’erreur.
• Details : l’ID du log, le chemin, la durée, l’ID de la clé API (credential_id), l’adresse IP, le user agent et l’ID de la requête.

Déboguer les erreurs 4xx

1. Filtrez sur les erreurs. Réglez Outcome sur Error, ou Status code sur le code reçu, et choisissez une période qui couvre l’échec.

2. Ouvrez la requête et lisez le corps de la réponse. Les corps d’erreur d’Emailit indiquent ce qui ne va pas. Les erreurs de validation listent chaque problème dans validation_errors ou details.

3. Comparez avec le corps de la requête. Vérifiez les champs qu’Emailit a reçus. Les surprises typiques sont un domaine from manquant, to envoyé sous forme d’objet ou un scheduled_at dans un format inattendu.

4. Adaptez la correction au code de statut.

   Statut	Cause fréquente	Pour en savoir plus
   400	JSON mal formé ou erreur de validation.	Erreurs
   401	Clé API absente ou invalide. Les clés inconnues ne sont pas enregistrées.	Authentification
   402	Pas assez de crédits pour l’envoi.	Crédits
   403	L’espace de travail n’est pas vérifié et un destinataire n’en est pas membre (unverified_workspace_recipient), la clé est restreinte à un autre domaine, la fonctionnalité nécessite un forfait supérieur (plan_required), ou l’espace de travail est suspendu.	Accès production
   409	Un doublon, ou une requête avec le même Idempotency-Key encore en cours.	Idempotence
   413	Le message dépasse 40 Mo.	Pièces jointes
   422	La requête est valide mais ne peut pas être exécutée, par exemple la relance d’un e-mail qui ne peut pas être relancé.	Erreurs
   429	Limite d’envoi par seconde ou quotidienne atteinte. Le corps inclut limit, current et retry_after.	Limites de débit

   Pour SMTP, les mêmes problèmes apparaissent sous forme de codes de réponse SMTP, par exemple 530 quand le domaine From n’est pas vérifié ou 452 pour les limites de débit. Consultez Dépannage SMTP.

5. Corrigez et renvoyez. Une requête qui a échoué avec un 4xx n’a pas créé d’e-mail : vous pouvez donc la renvoyer sans risque une fois corrigée.

Si la requête a réussi ici mais que l’e-mail n’est pas arrivé, le problème s’est produit plus tard. Trouvez l’e-mail dans Email API›Emails et consultez ses tentatives de livraison.

Conservation

Les logs de requêtes suivent la durée de conservation des Logs :

	Pay as you go	Pro	Business	Custom
Conservation des logs de requêtes	7 jours	30 jours	30 jours	Flexible

Les logs de requêtes ne sont disponibles que dans le tableau de bord ; aucun endpoint d’API ne les expose.

Voir aussi