Logs : Routes
Run Commands
Le point d'entrée unique pour les logs de livraison. Envoyez de 1 à 20 commandes en une requête et obtenez un résultat par commande.
https://g.sendcorex.com/v1/logsC'est la même enveloppe que Contacts : chaque lecture est une commande envoyée à cette route. Les pages sous celle-ci documentent chaque commande et ses arguments.
Les erreurs sont signalées par commande. Une commande qui échoue n'arrête pas les autres, et le statut HTTP reste 200.
Paramètres du corps
commandsobject[]obligatoire1 à 20 commandes, exécutées dans l'ordre. Le corps entier peut faire jusqu'à 1 MB.
commands[].commandstringobligatoirelist_logsouget_logs.commands[].argsobjectfacultatifLes arguments de la commande. Toute valeur peut être un
$refvers le résultat d'une commande précédente.commands[].idstringfacultatifVotre propre identifiant pour le résultat. Par défaut, l'index (
"0","1"…). Obligatoire si vous voulez utiliser$ref.
Démarrage rapide
import axios from 'axios';
const response = await axios.post(
'https://g.sendcorex.com/v1/logs',
{
commands: [
{
command: "list_logs",
id: "bounces",
args: {
status: "bounced",
limit: 20
}
},
{
command: "get_logs",
id: "one",
args: {
id: "3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f"
}
}
]
},
{ headers: { Authorization: process.env.SENDCOREX_API_KEY } },
);
for (const result of response.data.results) {
if (result.type !== 'SUCCESS') console.error(result.id, result.code, result.message);
else console.log(result.id, result.data);
}Réponse
{
"type": "SUCCESS",
"results": [
{
"command": "list_logs",
"id": "bounces",
"type": "SUCCESS",
"took_ms": 21,
"data": {
"logs": [
{
"id": "9b7e4c21-0d3a-4e8f-a6b1-5c2d7e9f1a30",
"to": "old.address@gmail.com",
"from": "noreply@yourdomain.com",
"domain": "gmail.com",
"from_domain": "yourdomain.com",
"subject": "Your order #1042 has shipped",
"status": "bounced",
"status_code": 6,
"response": "550 5.1.1 The email account that you tried to reach does not exist.",
"message": null,
"blocked": false,
"block_reason": null,
"retries": 0,
"tracking_id": "7CK-JDL-Z2M-20261017",
"sent_at": "2026-10-17T05:58:44.031Z",
"updated_at": "2026-10-17T05:58:45.600Z"
}
],
"count": 1,
"has_more": false,
"next_cursor": null,
"partial": false
}
},
{
"command": "get_logs",
"id": "one",
"type": "SUCCESS",
"took_ms": 9,
"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": []
}
}
]
}Champs de la réponse
typeToujours
SUCCESSlorsque la requête elle-même a été acceptée.results[].commandLa commande qui a produit ce résultat.
results[].idL'
idque vous avez envoyé, ou l'index de la commande.results[].typeSUCCESSouERROR.results[].took_msLe temps passé par la commande dans le serveur. Le reste du temps de la requête correspond au réseau.
results[].dataLa sortie de la commande. Présente uniquement lorsque
typevautSUCCESS.results[].code / messageL'erreur. Présente uniquement lorsque
typevautERROR.
Authentification
Les logs utilisent l'API key que vous créez dans le dashboard, sous Developers → API Keys, avec le scope logs:read. C'est le même type de key que celle utilisée pour envoyer des e-mails et gérer les contacts.
AuthorizationEnvoyez
Authorization: <api key>ouAuthorization: Bearer <api key>.logs:readLe seul scope dont les logs ont besoin. Il est en lecture seule : rien sur cette route ne modifie de données.
Tokens de mailboxLe token du webmail ne fonctionne pas ici. Il est rejeté avec
WRONG_CREDENTIAL_TYPE.IP autoriséesSi la key a une liste d'IP autorisées, les requêtes provenant d'autres IP reçoivent
403 IP_NOT_ALLOWED.RévocationLes keys sont mises en cache pendant 60 secondes, donc une key révoquée cesse de fonctionner en moins d'une minute. La date d'expiration est vérifiée à chaque requête.
Réutiliser un résultat précédent avec $ref
Toute valeur dans args peut être {"$ref": "<id>", "path": "<path>"}. Elle est remplacée par la valeur trouvée à path dans le résultat de la commande ayant cet id. Dans path, * parcourt une liste. Cette requête liste les derniers bounces et lit leur corps, en un seul aller-retour.
Corps de la requête
{
"commands": [
{
"command": "list_logs",
"id": "b",
"args": {
"status": "bounced",
"limit": 10
}
},
{
"command": "get_logs",
"args": {
"ids": {
"$ref": "b",
"path": "logs/*/id"
},
"include_content": true
}
}
]
}Ce que contiennent les logs
Chaque envoiChaque e-mail que vous envoyez reçoit un log, mis à jour à mesure que la livraison obtient un résultat.
60 joursLes logs sont conservés 60 jours. Les plus anciens disparaissent et leurs ids reviennent dans
not_found.Pas de warm-upLes e-mails envoyés par le warm-up de boîte de réception n'apparaissent jamais, donc le polling ne renvoie que votre trafic réel.
Pas de corps par défautLes listes ne contiennent jamais le HTML. Get Logs ne le renvoie qu'avec
include_content: true.
Rate limits et cache
Les limites s'appliquent par IP + API key. Il n'y a pas de file d'attente : au-delà, la requête est rejetée avec un HTTP 429 et un header Retry-After.
15 requêtes / secondePic de 15. Les réponses servies depuis le cache comptent aussi.
15 simultanéesAu maximum 15 requêtes traitées en même temps. Parcourir beaucoup de pages en parallèle est la façon habituelle d'atteindre cette limite : parcourez-les l'une après l'autre.
Cache de lecture : 1,5 sLa même lecture (même commande et mêmes args) à moins de 1,5 seconde d'intervalle renvoie le même résultat, et les lectures identiques en cours partagent une seule requête. Un polling toutes les quelques secondes ne pose aucun problème.
Cursors
List Logs renvoie next_cursor tant qu'il reste des résultats. Il est opaque : renvoyez-le tel quel, avec les mêmes filtres.
next_cursor
{
"has_more": true,
"next_cursor": "MDAwMDAwMDA4MzowOjgyMzkzMTU5OTg3OTU6M2YyYTFi",
"partial": false
}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.
- 400
INVALID_JSONLe corps n'est pas {"commands":[...]} ou dépasse 1 MB.
- 400
INVALID_ARGSLa requête ne contient aucune commande ou plus de 20.
- 401
MISSING_AUTH_HEADERAucun header Authorization n'a été envoyé.
- 401
INVALID_API_KEYL'API key n'existe pas, a été révoquée ou a été désactivée dans le dashboard.
- 401
API_KEY_EXPIREDL'API key a dépassé la date d'expiration définie dans le dashboard.
- 401
WRONG_CREDENTIAL_TYPEUn token de mailbox a été envoyé. Les logs nécessitent une API key du dashboard.
- 403
IP_NOT_ALLOWEDLa requête provient d'une IP qui ne figure pas parmi les IP autorisées de la key.
- 403
ACCOUNT_BLOCKEDLe compte est bloqué.
- 403
MISSING_SCOPELa key n'a pas `logs:read`, donc aucune commande ne peut s'exécuter.
- 429
RATE_LIMITEDPlus 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.
- 503
AUTH_UNAVAILABLEL'authentification est temporairement indisponible. Réessayez.
- CMD
UNKNOWN_COMMANDLe nom de la commande n'existe pas.
- CMD
INTERNALErreur serveur. Le détail n'est écrit que dans le log du serveur.