受信箱チェックに接続する

ゲスト 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.

保存したトークンを使用して続行します。別のテストを作成しないでください。

メッセージを送信した後、同じトークンを使用して別のスクリプトを実行します。作成スクリプトを再実行すると、異なるシード アドレスを持つ別のテストが作成されます。

// 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 を呼び出し続けます。タイムアウトはそのトークンを使用して再開できます。

これらのクライアントは public /api/tests を使用します。リモート MCP ゲスト ツールもキーなしで動作します。MCP 命令を使用してください。現在のセットアップ オプションはすべて /sdk/integration.json にリストされています。

登録なしの Webhook: ローカル SDK リレー

AI は、このリレーを独自の Node.js 環境にダウンロードして構成できます。 SAVED テスト トークンを読み取り、最終的な完了/期限切れのスナップショットを待ってから、1 つの署名付き 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 レシーバーに置き換えます。 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(secret, timestamp + "." + 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.

Relay はテストを作成したり、テスト電子メールを送信したりすることはありません。コールバック POST の再試行やリダイレクトの追跡は行いません。コールバックの配信が不確実な場合、エラーにはeventIdが含まれます: 再実行する前にレシーバーを確認してください。ポーリングがタイムアウトした場合は、トークン/構成を保持して同じテストを再開します。メッセージを受信せずに期限切れになった結果は、期限切れの結果のままになります。