เชื่อมต่อกับการตรวจสอบกล่องจดหมาย

Guest SDK: JavaScript และ Python

ดาวน์โหลดไคลเอนต์ที่ได้รับการดูแลโดยตรง Node.js 18+ หรือ Python 3.9+; ไม่จำเป็นต้องมีตัวจัดการแพ็คเกจ การขึ้นต่อกัน หรือคีย์ API

จาวาสคริปต์ SDK (.mjs) · หลาม SDK (.py)

จาวาสคริปต์

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 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(ความลับ, การประทับเวลา + "." + 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: ตรวจสอบผู้รับของคุณก่อนที่จะรันอีกครั้ง หากการโพลหมดเวลา ให้เก็บโทเค็น/การกำหนดค่าไว้และทำการทดสอบต่อเหมือนเดิม ผลลัพธ์ที่หมดอายุโดยไม่มีข้อความที่ได้รับจะยังคงเป็นผลลัพธ์ที่หมดอายุ