Подключение к Inbox Check

Гостевой SDK: JavaScript и Python

Скачайте клиент напрямую. Нужны Node.js 18+ или Python 3.9+; менеджер пакетов, зависимости и API-ключ не нужны.

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.

Продолжите с сохранённым токеном — не создавайте новую проверку

После отправки запустите отдельный скрипт с ТЕМ ЖЕ токеном. Повторный запуск скрипта создания выдаст другую проверку и другие адреса.

// 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 возвращает первый измеренный результат провайдера или завершённую проверку. Результат может быть частичным: проверяйте status и results, а для полного отчёта продолжайте getTest / get_test с тем же токеном до status done или expired. После таймаута чтение продолжается по этому токену.

Эти клиенты используют открытые методы /api/tests. Гостевые инструменты remote MCP тоже работают без ключа: откройте инструкцию MCP. Все актуальные способы настройки описаны в /sdk/integration.json.

Вебхуки без регистрации: локальный SDK-процесс

Ваш ИИ может скачать и настроить этот процесс в вашей среде Node.js. Он читает СОХРАНЁННЫЙ токен, дожидается итогового done/expired и отправляет одно подписанное событие check.completed вашему получателю. Процесс должен оставаться запущенным. Это не серверная подписка 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

Замените SAVED_TEST_TOKEN и YOUR_RECEIVER токеном уже созданной проверки и своим HTTPS-получателем. Configure создаёт новый закрытый файл со случайным секретом подписи; существующий файл не перезаписывается.

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

Перед запуском настройте получателя с тем же закрытым секретом. Проверяйте исходное тело запроса, X-Inbox-Check-Timestamp и X-Inbox-Check-Signature. Подпись: sha256=HMAC-SHA256(secret, timestamp + "." + rawBody). Отклоняйте просроченные подписи и исключайте повторы по 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.

Процесс не создаёт проверку и не отправляет проверяемое письмо. Он не повторяет POST уведомления и не следует перенаправлениям. При неопределённом исходе ошибка содержит eventId: проверьте получателя перед повторным запуском. При таймауте сохраните токен и конфигурацию и продолжите ту же проверку. Истёкшая проверка без полученных писем остаётся истёкшей.