Connettiti al controllo della posta in arrivo

SDK ospite: JavaScript e Python

Scarica direttamente il client gestito. Node.js 18+ o Python 3.9+; non sono necessari gestori di pacchetti, dipendenze o chiavi API.

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.

Pitone

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.

Continua con il token salvato: non creare un altro test

Dopo aver inviato il messaggio, esegui uno script separato utilizzando il token SAME. La riesecuzione dello script di creazione crea un altro test con indirizzi seed diversi.

// 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 restituisce la prima istantanea del provider misurata o un risultato del terminale. Può essere parziale: controlla lo stato e i risultati e continua a chiamare getTest / get_test con lo stesso token fino al completamento o alla scadenza dello stato se hai bisogno del rapporto finale completo. Un timeout è ripristinabile con quel token.

Questi client utilizzano /api/tests pubblici. Gli strumenti guest MCP remoti funzionano anche senza chiave: utilizzare le istruzioni MCP. Tutte le opzioni di configurazione correnti sono elencate in /sdk/integration.json.

Webhook senza registrazione: relè SDK locale

La tua IA può scaricare e configurare questo relè nel tuo ambiente Node.js. Legge un token di test SALVATO, attende lo snapshot finale completato/scaduto, quindi invia un evento check.completed firmato al ricevitore. Mantieni il processo in esecuzione. Questo non è un abbonamento al webhook Check ospitato.

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

Sostituisci SAVED_TEST_TOKEN e YOUR_RECEIVER con il token già creato e il tuo ricevitore HTTPS. Configure scrive un nuovo file privato con un segreto di firma casuale; si rifiuta di sovrascrivere un file esistente.

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

Configura il tuo ricevitore con lo stesso segreto privato prima di eseguirlo. Verificare il corpo della richiesta non elaborata, X-Inbox-Check-Timestamp e X-Inbox-Check-Signature. La firma è sha256=HMAC-SHA256(segreto, timestamp + "." + rawBody). Rifiuta i timestamp obsoleti e deduplica 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.

Il relè non crea mai un test né invia un'e-mail di prova. Non riprova i POST di callback né segue i reindirizzamenti. Se la consegna della richiamata è incerta, l'errore include eventId: controlla il ricevitore prima di rieseguire. Se il polling scade, conservare il token/la configurazione e riprendere lo stesso test. Un risultato scaduto senza messaggi ricevuti rimane un risultato scaduto.