받은편지함 확인에 연결

게스트 SDK: JavaScript 및 Python

유지관리 클라이언트를 직접 다운로드하세요. Node.js 18+ 또는 Python 3.9+; 패키지 관리자, 종속성 또는 API 키가 필요하지 않습니다.

자바스크립트 SDK(.mjs) · Python 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에 나열되어 있습니다.

등록되지 않은 웹후크: 로컬 SDK 릴레이

AI는 자신의 Node.js 환경에서 이 릴레이를 다운로드하고 구성할 수 있습니다. SAVED 테스트 토큰을 읽고 최종 완료/만료된 스냅샷을 기다린 다음 서명된 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(비밀, 타임스탬프 + "." + 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가 포함됩니다. 다시 실행하기 전에 수신자를 확인하세요. 폴링 시간이 초과되면 토큰/구성을 유지하고 동일한 테스트를 재개하십시오. 메시지가 수신되지 않은 만료된 결과는 만료된 결과로 유지됩니다.