Stellen Sie eine Verbindung zur Posteingangsprüfung her

Gast-SDK: JavaScript und Python

Laden Sie den gepflegten Client direkt herunter. Node.js 18+ oder Python 3.9+; Kein Paketmanager, Abhängigkeiten oder API-Schlüssel erforderlich.

JavaScript SDK (.mjs) · Python SDK (.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.

Fahren Sie mit dem gespeicherten Token fort – erstellen Sie keinen weiteren Test

Führen Sie nach dem Senden der Nachricht ein separates Skript mit dem SAME-Token aus. Durch erneutes Ausführen des Erstellungsskripts wird ein weiterer Test mit anderen Startadressen erstellt.

// 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 gibt den ersten gemessenen Provider-Snapshot oder ein Terminalergebnis zurück. Es kann teilweise sein: Überprüfen Sie den Status und die Ergebnisse und rufen Sie getTest / get_test weiterhin mit demselben Token auf, bis der Status abgeschlossen oder abgelaufen ist, wenn Sie den vollständigen Abschlussbericht benötigen. Eine Zeitüberschreitung kann mit diesem Token fortgesetzt werden.

Diese Clients verwenden öffentliche /api/tests. Remote-MCP-Gasttools funktionieren auch ohne Schlüssel: Verwenden Sie die MCP-Anweisungen. Alle aktuellen Setup-Optionen sind in /sdk/integration.json aufgeführt.

Webhooks ohne Registrierung: lokales SDK-Relay

Ihre KI kann dieses Relay in Ihrer eigenen Node.js-Umgebung herunterladen und konfigurieren. Es liest ein SAVED-Testtoken, wartet auf den endgültigen fertigen/abgelaufenen Snapshot und sendet dann ein signiertes check.completed-Ereignis an Ihren Empfänger. Halten Sie den Prozess am Laufen. Dies ist kein gehostetes Check-Webhook-Abonnement.

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

Ersetzen Sie SAVED_TEST_TOKEN und YOUR_RECEIVER durch das bereits erstellte Token und Ihren eigenen HTTPS-Empfänger. Konfigurieren schreibt eine neue private Datei mit einem zufälligen Signaturgeheimnis; Es weigert sich, eine vorhandene Datei zu überschreiben.

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

Konfigurieren Sie Ihren Receiver vor dem Ausführen mit demselben privaten Geheimnis. Überprüfen Sie den rohen Anforderungstext, den X-Inbox-Check-Timestamp und die X-Inbox-Check-Signatur. Die Signatur ist sha256=HMAC-SHA256(geheim, Zeitstempel + „.“ + rawBody). Veraltete Zeitstempel ablehnen und event.id deduplizieren.

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.

Das Relay erstellt niemals einen Test und sendet keine Test-E-Mail. Es werden keine Rückruf-POSTs wiederholt und Weiterleitungen nicht verfolgt. Wenn die Zustellung des Rückrufs unsicher ist, enthält der Fehler die Ereignis-ID: Überprüfen Sie Ihren Empfänger, bevor Sie ihn erneut ausführen. Wenn bei der Abfrage eine Zeitüberschreitung auftritt, behalten Sie das Token/die Konfiguration bei und setzen Sie den gleichen Test fort. Ein abgelaufenes Ergebnis ohne empfangene Nachrichten bleibt ein abgelaufenes Ergebnis.