Logs : Lecture

Obtenir les logs

Lisez jusqu'à 50 logs par ID d'e-mail, l'`id` que vous recevez à l'envoi. Ajoutez `include_content` pour obtenir le HTML qui a été livré.

POSThttps://g.sendcorex.com/v1/logscommand: get_logs
i

Nécessite le scope logs:read sur votre API key.

i

Rechercher un ID coûte la même chose quel que soit le nombre d'e-mails que vous envoyez : il n'y a aucun scan derrière.

Arguments

  • idsstring[]facultatif

    Jusqu'à 50 ID d'e-mail (UUID). Les ids répétés comptent une seule fois.

    ex. : ["3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f"]

  • idstringfacultatif

    Un seul ID d'e-mail. Utilisez ce paramètre ou ids.

    ex. : "3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f"

  • include_contentbooleanfacultatif

    Renvoie aussi le HTML de chaque e-mail. Avec ce paramètre, la limite est de 10 ids par commande.

    ex. : true

Démarrage rapide

import axios from 'axios';

const response = await axios.post(
  'https://g.sendcorex.com/v1/logs',
  {
    commands: [
      {
        command: "get_logs",
        args: {
          ids: [
            "3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f",
            "00000000-0000-4000-8000-000000000000"
          ]
        }
      }
    ]
  },
  { headers: { Authorization: process.env.SENDCOREX_API_KEY } },
);

const [result] = response.data.results;
if (result.type !== 'SUCCESS') throw new Error(`${result.code}: ${result.message}`);
console.log(result.data);

Réponse

{
  "type": "SUCCESS",
  "results": [
    {
      "command": "get_logs",
      "id": "0",
      "type": "SUCCESS",
      "took_ms": 18,
      "data": {
        "logs": [
          {
            "id": "3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f",
            "to": "ana@acme.com",
            "from": "noreply@yourdomain.com",
            "domain": "acme.com",
            "from_domain": "yourdomain.com",
            "subject": "Your order #1042 has shipped",
            "status": "delivered",
            "status_code": 2,
            "response": "250 2.0.0 OK 1760684401 a1si123456",
            "message": null,
            "blocked": false,
            "block_reason": null,
            "retries": 0,
            "tracking_id": "7CK-JDL-Y1L-20261017",
            "sent_at": "2026-10-17T06:00:01.204Z",
            "updated_at": "2026-10-17T06:00:02.913Z"
          }
        ],
        "not_found": [
          "00000000-0000-4000-8000-000000000000"
        ]
      }
    }
  ]
}

Champs de la réponse

  • logs

    Les logs trouvés, dans l'ordre où vous les avez demandés.

  • not_found

    Les ids qui n'existent pas dans votre compte, datent de plus de 60 jours ou appartiennent à des e-mails de warm-up.

  • logs[].id

    L'ID de l'e-mail (un UUID). C'est l'id que vous recevez à l'envoi, et celui que vous passez à Get Logs.

  • logs[].to / logs[].domain

    Le destinataire et le domaine du destinataire.

  • logs[].from_domain

    Le domaine de l'expéditeur (la partie après @ dans from).

  • logs[].from

    L'adresse de l'expéditeur.

  • logs[].subject

    La ligne d'objet.

  • logs[].status

    delivered, bounced, spam, rate_limited ou not_sent. status_code est la même chose sous forme de nombre.

  • logs[].response

    Ce que le serveur destinataire a répondu, par exemple 250 2.0.0 OK ou la raison du bounce 550.

  • logs[].message

    Un détail supplémentaire de Sendcorex sur la livraison, le cas échéant.

  • logs[].blocked / logs[].block_reason

    true lorsque Sendcorex n'a pas envoyé à ce destinataire (supprimé ou restreint), et pourquoi.

  • logs[].retries

    Le nombre de nouvelles tentatives de livraison.

  • logs[].tracking_id

    L'id interne de la livraison. Les webhooks de bounce et de plainte portent la même valeur.

  • logs[].sent_at / logs[].updated_at

    Quand l'e-mail a été envoyé et quand son statut a changé pour la dernière fois. ISO 8601, UTC.

  • logs[].content.html

    Le HTML qui a été livré. Uniquement avec include_content: true ; null lorsque le corps n'a pas été conservé.

Lire le corps

Le corps est la partie la plus lourde d'un log, il n'est donc renvoyé que sur demande. C'est le HTML tel qu'il a été livré : si le tracking était activé, il peut contenir le pixel de suivi et des liens réécrits.

Corps de la requête

{
  "commands": [
    {
      "command": "get_logs",
      "args": {
        "id": "3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f",
        "include_content": true
      }
    }
  ]
}
!

Afficher ce HTML peut charger le pixel de suivi et compter comme une ouverture. Affichez-le dans un iframe en sandbox avec les images distantes bloquées, comme le fait le dashboard.

Détails d'une page de List Logs

Enchaînez les deux commandes avec $ref : les ids de la liste passent directement dans Get Logs, en une seule requête.

Corps de la requête

{
  "commands": [
    {
      "command": "list_logs",
      "id": "bounces",
      "args": {
        "status": "bounced",
        "limit": 10
      }
    },
    {
      "command": "get_logs",
      "args": {
        "ids": {
          "$ref": "bounces",
          "path": "logs/*/id"
        },
        "include_content": true
      }
    }
  ]
}

Erreurs

Les erreurs au niveau HTTP renvoient type, code et message. Les erreurs marquées CMD reviennent dans le résultat de la commande, avec HTTP 200.

  • 401INVALID_API_KEY

    L'API key n'existe pas, a été révoquée ou a été désactivée dans le dashboard.

  • 429RATE_LIMITED

    Plus de 15 requêtes/s ou 15 simultanées pour la même IP + API key. Attendez le nombre de secondes indiqué dans Retry-After.

  • CMDMISSING_SCOPE

    L'API key n'a pas `logs:read`.

  • CMDINVALID_ARGS

    Un argument est invalide : statut inconnu, destinataire qui n'est pas un e-mail complet, limit hors limites, id qui n'est pas un UUID, after postérieur à before…

  • CMDINTERNAL

    Erreur serveur. Le détail n'est écrit que dans le log du serveur.