# Logs de requêtes

> Examinez chaque requête API v2 et chaque transaction SMTP effectuée avec vos clés API, y compris les corps de requête et de réponse, pour déboguer les erreurs 4xx.

**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. »

| Source | Ce qui est enregistré |
| --- | --- |
| **API** | Chaque requête vers `https://api.emailit.com/v2/…` qu’Emailit peut rattacher à votre espace de travail : méthode, chemin, code de statut, durée, clé API, adresse IP, user agent, et corps de la requête et de la réponse. |
| **SMTP** | Chaque commande `DATA`, avec le résultat (`250 2.0.0 OK: queued as em_…` ou l’erreur), l’expéditeur d’enveloppe, les destinataires, les en-têtes et la taille du message. Également les refus de `MAIL FROM` dus aux limites de débit (`452`) et les tentatives `AUTH` échouées avec une clé API révoquée (`535`). |

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](/fr/docs/api-reference/errors/) |
   | `401` | Clé API absente ou invalide. Les clés inconnues ne sont pas enregistrées. | [Authentification](/fr/docs/api-reference/authentication/) |
   | `402` | Pas assez de crédits pour l’envoi. | [Crédits](/fr/docs/billing/credits/) |
   | `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](/fr/docs/workspaces/production-access/) |
   | `409` | Un doublon, ou une requête avec le même `Idempotency-Key` encore en cours. | [Idempotence](/fr/docs/api-reference/idempotency/) |
   | `413` | Le message dépasse 40 Mo. | [Pièces jointes](/fr/docs/email-api/attachments/) |
   | `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](/fr/docs/api-reference/errors/) |
   | `429` | Limite d’envoi par seconde ou quotidienne atteinte. Le corps inclut `limit`, `current` et `retry_after`. | [Limites de débit](/fr/docs/api-reference/rate-limits/) |

   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](/fr/docs/smtp/troubleshooting/).

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](/fr/docs/logs/email-details/#deliveries-loads-and-clicks).

## 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

  - [Erreurs de l’API](/fr/docs/api-reference/errors/)
  - [Dépannage SMTP](/fr/docs/smtp/troubleshooting/)

---
Source: https://emailit.com/fr/docs/logs/request-logs/