Kết nối với Kiểm tra hộp thư đến

SDK khách: JavaScript và Python

Tải xuống ứng dụng khách được duy trì trực tiếp. Node.js 18+ hoặc Python 3.9+; không cần trình quản lý gói, phần phụ thuộc hoặc khóa API.

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

Tiếp tục với mã thông báo đã lưu - không tạo thử nghiệm khác

Sau khi gửi tin nhắn, hãy chạy một tập lệnh riêng bằng mã thông báo CÙNG. Chạy lại tập lệnh tạo sẽ tạo một thử nghiệm khác với các địa chỉ hạt giống khác.

// 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 trả về ảnh chụp nhanh nhà cung cấp được đo lường đầu tiên hoặc kết quả cuối cùng. Nó có thể là một phần: kiểm tra trạng thái và kết quả, đồng thời tiếp tục gọi getTest / get_test bằng cùng một mã thông báo cho đến khi trạng thái hoàn tất hoặc hết hạn nếu bạn cần báo cáo cuối cùng đầy đủ. Thời gian chờ có thể tiếp tục với mã thông báo đó.

Những khách hàng này sử dụng public /api/tests. Công cụ khách MCP từ xa cũng hoạt động mà không cần chìa khóa: sử dụng hướng dẫn MCP. Tất cả các tùy chọn thiết lập hiện tại đều được liệt kê trong /sdk/integration.json.

Webhooks không cần đăng ký: chuyển tiếp SDK cục bộ

AI của bạn có thể tải xuống và định cấu hình rơle này trong môi trường Node.js của riêng bạn. Nó đọc mã thông báo kiểm tra SAVED, chờ ảnh chụp nhanh cuối cùng được thực hiện/hết hạn, sau đó gửi một sự kiện check.completed đã ký tới người nhận của bạn. Giữ cho quá trình chạy. Đây không phải là đăng ký webhook Kiểm tra được lưu trữ.

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

Thay thế SAVED_TEST_TOKEN và YOUR_RECEIVER bằng mã thông báo đã được tạo và bộ thu HTTPS của riêng bạn. Định cấu hình ghi một tệp riêng tư mới với bí mật ký ngẫu nhiên; nó từ chối ghi đè lên một tập tin hiện có.

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

Định cấu hình bộ thu của bạn với cùng một bí mật riêng tư trước khi chạy. Xác minh nội dung yêu cầu thô, X-Inbox-Check-Timestamp và X-Inbox-Check-Signature. Chữ ký là sha256=HMAC-SHA256(bí mật, dấu thời gian + "." + rawBody). Từ chối dấu thời gian cũ và loại bỏ sự kiện.id trùng lặp.

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.

Rơle không bao giờ tạo bài kiểm tra hoặc gửi email kiểm tra. Nó không thử lại các POST gọi lại hoặc theo dõi các chuyển hướng. Nếu việc phân phối lệnh gọi lại không chắc chắn thì lỗi bao gồm eventId: hãy kiểm tra bộ thu của bạn trước khi chạy lại. Nếu bỏ phiếu hết thời gian, hãy giữ lại mã thông báo/cấu hình và tiếp tục kiểm tra tương tự. Kết quả đã hết hạn mà không nhận được tin nhắn nào vẫn là kết quả đã hết hạn.