Se connecter à la boîte de réception

SDK invité : JavaScript et Python

Téléchargez directement le client maintenu. Node.js 18+ ou Python 3.9+ ; aucun gestionnaire de packages, dépendances ou clé API n'est nécessaire.

SDK JavaScript (.mjs) · SDK Python (.py)

Javascript

curl -fsS https://check.live-direct-marketing.online/sdk/inbox-check.mjs -o inbox-check.mjs

// Save as check.mjs, replace the sender address, then run: node check.mjs
import { InboxCheck } from './inbox-check.mjs';
const client = new InboxCheck();
const test = await client.createTest({ email: 'you@example.com' });
console.log(test); // Keep token, send_to and results_url.
// Send your own email to ALL send_to addresses before waiting.
// Save the returned token; use the separate read script below.

Python

curl -fsS https://check.live-direct-marketing.online/sdk/inbox_check.py -o inbox_check.py

# Save as check.py, replace the sender address, then run: python3 check.py
from inbox_check import InboxCheck
client = InboxCheck()
test = client.create_test('you@example.com')
print(test)  # Keep token, send_to and results_url.
# Send your own email to ALL send_to addresses before waiting.
# Save the returned token; use the separate read script below.

Continuez avec le jeton enregistré — ne créez pas un autre test

Après avoir envoyé le message, exécutez un script distinct à l'aide du jeton SAME. La réexécution du script de création crée un autre test avec des adresses de départ différentes.

// Save as read.mjs, replace YOUR_TEST_TOKEN, then: node read.mjs
import { InboxCheck } from './inbox-check.mjs';
const client = new InboxCheck();
const report = await client.waitForResult('YOUR_TEST_TOKEN');
console.log(report);

# Save as read.py, replace YOUR_TEST_TOKEN, then: python3 read.py
from inbox_check import InboxCheck
client = InboxCheck()
report = client.wait_for_result('YOUR_TEST_TOKEN')
print(report)

waitForResult / wait_for_result renvoie le premier instantané du fournisseur mesuré ou un résultat de terminal. Cela peut être partiel : inspectez le statut et les résultats, et continuez à appeler getTest / get_test avec le même jeton jusqu'à ce que le statut soit terminé ou expiré si vous avez besoin du rapport final complet. Un délai d'attente peut être repris avec ce jeton.

Ces clients utilisent public /api/tests. Les outils invités MCP distants fonctionnent également sans clé : utilisez les instructions MCP. Toutes les options de configuration actuelles sont répertoriées dans /sdk/integration.json.

Webhooks sans inscription : relais SDK local

Votre IA peut télécharger et configurer ce relais dans votre propre environnement Node.js. Il lit un jeton de test ENREGISTRÉ, attend l'instantané final terminé/expiré, puis envoie un événement check.completed signé à votre récepteur. Maintenez le processus en cours. Il ne s’agit pas d’un abonnement au webhook Check hébergé.

curl -fsS https://check.live-direct-marketing.online/sdk/inbox-check.mjs -o inbox-check.mjs
curl -fsS https://check.live-direct-marketing.online/sdk/inbox-check-webhooks.mjs -o inbox-check-webhooks.mjs

Remplacez SAVED_TEST_TOKEN et YOUR_RECEIVER par le jeton déjà créé et votre propre récepteur HTTPS. Configure écrit un nouveau fichier privé avec un secret de signature aléatoire ; il refuse d'écraser un fichier existant.

node inbox-check-webhooks.mjs configure --token SAVED_TEST_TOKEN --url https://YOUR_RECEIVER/hook --config ./inbox-check-webhook.json
node inbox-check-webhooks.mjs run --config ./inbox-check-webhook.json

Configurez votre récepteur avec le même secret privé avant de l'exécuter. Vérifiez le corps brut de la demande, X-Inbox-Check-Timestamp et X-Inbox-Check-Signature. La signature est sha256=HMAC-SHA256(secret, horodatage + "." + rawBody). Rejetez les horodatages obsolètes et dédoublonnez event.id.

import { verifyWebhook } from './inbox-check-webhooks.mjs';
// Receiver: use your privately configured shared secret and RAW request body.
const valid = verifyWebhook({
  body: rawBody, secret: privateSharedSecret,
  timestamp: request.headers['x-inbox-check-timestamp'],
  signature: request.headers['x-inbox-check-signature']
});
// Reject invalid signatures before parsing/acting on the event.
// Deduplicate JSON.parse(rawBody).id before processing a valid event.

Le relais ne crée jamais de test ni n'envoie d'email de test. Il ne réessaye pas les POST de rappel et ne suit pas les redirections. Si la livraison du rappel est incertaine, l'erreur inclut eventId : vérifiez votre récepteur avant de réexécuter. Si l'interrogation expire, conservez le jeton/la configuration et reprenez le même test. Un résultat expiré sans message reçu reste un résultat expiré.