连接到收件箱检查

访客 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.

蟒蛇

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.

继续使用保存的令牌 - 不要创建另一个测试

发送消息后，使用 SAME 令牌运行单独的脚本。重新运行创建脚本会创建另一个具有不同种子地址的测试。

// 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/tests。远程 MCP 访客工具也无需密钥即可工作：使用 MCP 指令。所有当前设置选项都列在 /sdk/integration.json 中。

无需注册的 Webhooks：本地 SDK 中继

您的 AI 可以在您自己的 Node.js 环境中下载并配置此中继。它读取已保存的测试令牌，等待最终完成/过期的快照，然后向您的接收者发送一个签名的 check.completed 事件。保持进程运行。这不是托管的 Check webhook 订阅。

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 接收器。配置使用随机签名秘密写入一个新的私有文件；它拒绝覆盖现有文件。

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, 时间戳 + "." + 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：在重新运行之前检查您的接收器。如果轮询超时，请保留令牌/配置并恢复相同的测试。未收到消息的过期结果仍然是过期结果。