Połącz się ze skrzynką odbiorczą

Gościnny zestaw SDK: JavaScript i Python

Pobierz bezpośrednio obsługiwanego klienta. Node.js 18+ lub Python 3.9+; nie jest potrzebny menedżer pakietów, zależności ani klucz API.

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

Pyton

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.

Kontynuuj z zapisanym tokenem – nie twórz kolejnego testu

Po wysłaniu wiadomości uruchom osobny skrypt korzystając z tokena SAME. Ponowne uruchomienie skryptu tworzenia tworzy kolejny test z różnymi adresami początkowymi.

// 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 zwraca pierwszą zmierzoną migawkę dostawcy lub wynik końcowy. Może być częściowy: sprawdź status i wyniki i kontynuuj wywoływanie getTest / get_test z tym samym tokenem, aż status zostanie wykonany lub wygaśnie, jeśli potrzebujesz pełnego raportu końcowego. Limit czasu można wznowić za pomocą tego tokena.

Ci klienci korzystają z publicznego /api/tests. Zdalne narzędzia gościnne MCP działają również bez klucza: skorzystaj z instrukcji MCP. Wszystkie bieżące opcje konfiguracji są wymienione w pliku /sdk/integration.json.

Webhooki bez rejestracji: lokalny przekaźnik SDK

Twoja sztuczna inteligencja może pobrać i skonfigurować ten przekaźnik w Twoim własnym środowisku Node.js. Odczytuje token testowy SAVED, czeka na ostatnią wykonaną/wygasłą migawkę, a następnie wysyła do odbiornika jedno podpisane zdarzenie check.completed. Utrzymuj proces w toku. To nie jest hostowana subskrypcja elementu webhook Check.

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

Zamień SAVED_TEST_TOKEN i YOUR_RECEIVER na już utworzony token i własny odbiornik HTTPS. Configure zapisuje nowy prywatny plik z losowym sekretem podpisu; odmawia zastąpienia istniejącego pliku.

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

Przed uruchomieniem skonfiguruj odbiornik z tym samym kluczem prywatnym. Sprawdź surową treść żądania, X-Inbox-Check-Timestamp i X-Inbox-Check-Signature. Podpis to sha256=HMAC-SHA256(tajny, znacznik czasu + „.” + rawBody). Odrzuć nieaktualne znaczniki czasu i usuń duplikat 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.

Przekaźnik nigdy nie tworzy testu ani nie wysyła testowej wiadomości e-mail. Nie ponawia prób wywołania zwrotnego POST ani nie podąża za przekierowaniami. Jeśli dostarczenie wywołania zwrotnego jest niepewne, błąd zawiera eventId: sprawdź odbiornik przed ponownym uruchomieniem. Jeśli upłynie limit czasu odpytywania, zachowaj token/config i wznów ten sam test. Wygasły wynik bez odebranych wiadomości pozostaje wynikiem wygasłym.