Підключіться до 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.

Продовжити зі збереженим маркером — не створювати інший тест

Після надсилання повідомлення запустіть окремий сценарій, використовуючи ТОЙ ЖЕ маркер. Повторний запуск сценарію create створює інший тест з іншими початковими адресами.

// 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 повертає перший виміряний знімок постачальника або кінцевий результат. Він може бути частковим: перевірте статус і результати та продовжуйте викликати getTest / get_test з тим самим маркером, доки статус не буде виконано або не закінчиться, якщо вам потрібен повний остаточний звіт. Тайм-аут можна відновити за допомогою цього маркера.

Ці клієнти використовують публічні /api/тести. Віддалені гостьові інструменти MCP також працюють без ключа: використовуйте інструкції MCP. Усі поточні параметри налаштування перераховані в /sdk/integration.json.

Вебхуки без реєстрації: локальний реле SDK

Ваш штучний інтелект може завантажити та налаштувати це реле у вашому власному середовищі Node.js. Він зчитує ЗБЕРЕЖЕНИЙ тестовий маркер, чекає на останній зроблений/прострочений знімок, а потім надсилає одну підписану подію check.completed вашому отримувачу. Продовжуйте процес. Це не розміщена підписка на перевірку вебхука.

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(секрет, позначка часу + "." + 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: перевірте приймача перед повторним запуском. Якщо час очікування закінчився, збережіть маркер/конфігурацію та відновіть той самий тест. Застарілий результат без отриманих повідомлень залишається простроченим результатом.