اللغة

الاتصال بفحص البريد الوارد

ابدأ مجانًا باستخدام واجهة برمجة التطبيقات العامة أو قم بتنزيل SDK. لا يوجد حساب أو مفتاح API مطلوب.

API مجاني - ابدأ بدون تسجيل الدخول

البريد الإلكتروني المرسل الخاص بك هو مدخل فني للاختبار، وليس خطوة تسجيل أو تحقق. استبدل you@example.com بالعنوان الذي سترسل منه.

استخدم JavaScript/Python SDK · تشغيل في المتصفح

1. قم بإنشاء اختبار مجاني

curl -X POST https://check.live-direct-marketing.online/api/tests   -H "Content-Type: application/json"   -d '{"email":"you@example.com","senderLinkReports":false,"placementChangeAlertsEnabled":false,"finalReportEnabled":false}'

تحتوي الاستجابة على الرمز المميز وsend_to وresults_url وexpires_at. قم بتخزينها قبل إغلاق جهازك الطرفي. تعمل الأمثلة على تعطيل رسائل البريد الإلكتروني للتذكير/التقرير؛ لا يطلبون رسائل البريد الإلكتروني لتسجيل الدخول.

2. أرسل بريدك الإلكتروني الخاص

أرسل الرسالة التي تريد التحقق منها من هذا العنوان من خلال خدمة البريد الإلكتروني المعتادة لديك إلى جميع العناوين في send_to. إنشاء اختبار لا يرسله لك.

3. اقرأ النتيجة

curl https://check.live-direct-marketing.online/api/tests/YOUR_TEST_TOKEN

استبدل YOUR_TEST_TOKEN بالرمز المميز من الخطوة 1، أو افتح results_url. أثناء الانتظار، استمر في الاقتراع كل بضع ثوانٍ. فحص النتائج والملخص والمصادقة: حالة الوحدة الطرفية وحدها لا تثبت تسليم البريد الوارد. حافظ على خصوصية رمزك المميز؛ ليست هناك حاجة إلى حساب لقراءة التقرير الخاص بك.

400: إصلاح الطلب. 429: انتظر حتى إعادة التعيين / إعادة المحاولة بعد. يؤدي فشل الشبكة أثناء إنشاء الاختبار إلى نتيجة غير معروفة: لا تكرر عملية POST تلقائيًا. احتفظ بالرمز المميز عند الاقتراع. تشتمل مهلة الانتظار الشاملة على الرمز المميز واللقطة الأخيرة حتى تتمكن من الاستئناف دون تسجيل الدخول.

ضيف SDK: جافا سكريبت وبيثون

قم بتنزيل العميل الذي تمت صيانته مباشرة. 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.

خطافات الويب بدون تسجيل: ترحيل SDK المحلي

يستطيع الذكاء الاصطناعي الخاص بك تنزيل هذا التتابع وتكوينه في بيئة Node.js الخاصة بك. فهو يقرأ رمز اختبار محفوظ، وينتظر اللقطة النهائية التي تم الانتهاء منها/منتهية الصلاحية، ثم يرسل حدثًا مكتملًا للفحص موقعًا إلى جهاز الاستقبال الخاص بك. حافظ على سير العملية. هذا ليس اشتراكًا مستضافًا للتحقق من webhook.

قم بتنزيل ترحيل 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.

لا يقوم المرحل مطلقًا بإنشاء اختبار أو يرسل بريدًا إلكترونيًا للاختبار. ولا يقوم بإعادة محاولة عمليات رد الاتصال أو متابعة عمليات إعادة التوجيه. إذا كان تسليم رد الاتصال غير مؤكد، فإن الخطأ يتضمن معرف الحدث: تحقق من جهاز الاستقبال الخاص بك قبل إعادة التشغيل. إذا انتهت مهلة الاستقصاء، فاحتفظ بالرمز المميز/التكوين واستأنف الاختبار نفسه. النتيجة منتهية الصلاحية مع عدم وجود رسائل مستلمة تظل نتيجة منتهية الصلاحية.

حساب اختياري وحدود أعلى وعمليات تكامل مُدارة

مفتاح الاتصال الخاص بك

قم بتسجيل الدخول باستخدام رابط البريد الإلكتروني. يؤدي تسجيل دخولك المؤكد الأول إلى إنشاء حسابك ومفتاحك تلقائيًا في الحساب.

إنشاء حساب تسجيل الدخول افتح الحساب

الأساسية: بشكل افتراضي، 100 اختبار يوميًا و1000 اختبار شهريًا، بدون لقطات شاشة. يُظهر الحساب وme_get الحدود والاستخدام الدقيق. اطلب باقة 500/5000 المجانية في الحساب؛ يبدأ بعد الموافقة.

يمكن إظهار المفاتيح الجديدة ونسخها مرة أخرى بعد تسجيل الدخول. لا تزال المفاتيح القديمة تعمل ولكن لا يمكن استعادتها: قم بإنشاء بديل، وقم بتحديث التكامل، ثم قم بإلغاء المفتاح القديم. حافظ على خصوصية مفتاحك.

1. تحقق من الاتصال

استبدل YOUR_API_KEY بمفتاحك. يعرض GET /api/v1/me حدود هذا المفتاح وعمليات التحقق المتبقية. لا يستهلك الاختبار.

curl https://check.live-direct-marketing.online/api/v1/me \
  -H "Authorization: Bearer YOUR_API_KEY"

2. قم بإنشاء اختبار

يستخدم الاختبار الذي تم إنشاؤه بنجاح فحصًا واحدًا. اختر الموفرين المتاحين لمفتاحك باستخدام GET /api/v1/providers.

curl -X POST https://check.live-direct-marketing.online/api/v1/tests \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"providers":["gmail","outlook"],"recipient_email":"you@example.com"}'

3. أرسل بريدك الإلكتروني الخاص

تحتوي الاستجابة على عناوين send_to وresults_url. أرسل بريدك الإلكتروني من الخدمة البريدية الخاصة بك إلى جميع العناوين التي تم إرجاعها. إنشاء اختبار لا يرسل لك بريدًا إلكترونيًا.

4. افتح التقرير

افتح results_url، أو اقرأ GET /api/v1/tests/:token. نتائج القراءة لا تستهلك الاختبار. تختلف أوقات التسليم؛ الرسالة المفقودة ليست دليلاً على التسليم الناجح.

الحدود والتاريخ

تتضمن Basic افتراضيًا 100 عملية تحقق يوميًا و1,000 شهريًا. قد تختلف الحدود الفعلية: استخدم /api/v1/me للمفتاح الحالي وصفحة الحساب لجميع مفاتيحك. عدد عمليات التحقق المتاحة هو الأصغر بين العدد المتبقي من الحد اليومي والعدد المتبقي من الحد الشهري.

يتم إعادة تعيين الفترات في الساعة 00:00 بالتوقيت العالمي المنسق كل يوم وفي اليوم الأول من الشهر. يعرض الحساب عمليات إعادة التعيين بالتوقيت المحلي. يتم حساب طلبات واجهة برمجة التطبيقات (API) والطلبات الفاشلة بشكل منفصل عن عمليات التحقق.

يحتفظ سجل الحساب بتفاصيل الطلب لمدة 30 يومًا باستخدام الفلاتر وصفحات 20/50 صفًا. تبدأ التغطية في التاريخ الموضح هناك؛ قد تكون السجلات السابقة غير مكتملة. لا يتم تضمين هيئات الطلب وملفات تعريف الارتباط والأسرار.

اطلب حزمة مجانية أكبر

استخدم طلب الحزمة المجانية في الحساب. بعد الموافقة تصبح حدود المفتاح المحدد 500 يوميا و5000 شهريا. وهذا يستبدل حدوده؛ لا يضيف الاختبارات أو الاستخدام الواضح. حتى الموافقة، تظل الحدود الحالية. القرار يصل عن طريق البريد الإلكتروني.

يمكن للمفتاح المرتبط بالمستخدم مع الحساب: القراءة قراءة طلباته الخاصة على GET /api/v1/account/promo-requests. الوصول للقراءة لا يسمح بإنشاء الطلبات أو الموافقة عليها؛ استخدم الحساب الذي تم تسجيل الدخول إليه لطلب الحزمة.

إذا فشل الطلب

تتم إدارة API فقط: 401 يعني التحقق من مفتاح Bearer؛ 403 يعني التحقق من أذوناته. بالنسبة لـ quota_exceeded، تحقق من كلا الحدين. احترام 429 / إعادة المحاولة بعد. بالنسبة لأخطاء الخادم، افحص النتيجة قبل تكرار عملية الإنشاء. احتفظ بمعرف الطلب عند الاتصال بالدعم، ولكن لا ترسل مفتاحك أبدًا.

مرجع API الكامل والتكامل

واجهة برمجة التطبيقات المفتوحة · MCP · أ2أ

تتضمن المفاتيح الافتراضية الجديدة أذونات محددة للمراقبة الخاصة بك، دون وصول المسؤول. تظل أذونات المفاتيح الحالية دون تغيير. تظل المفاتيح المقيدة خيارًا صريحًا في إعدادات الحساب.

مرجع متقدم: نقاط النهاية والطبقات والتعليمات البرمجية

يسرد OpenAPI المسارات ومخططات الطلب المتاحة. لم يتم الإعلان عن بعض مخططات الاستجابة؛ استخدم الأمثلة وحقول الاستجابة الفعلية. تستخدم المكالمات المُدارة التفويض: Bearer YOUR_API_KEY. تتطلب مراقبة الطفرات المراقبة: الكتابة؛ تتطلب القراءات المراقبة: قراءة ومفتاح مرتبط بالمستخدم.

GET /api/v1/me: البيانات التعريفية الرئيسية والميزات والموفرين المسموح بهم والحصص وأوقات إعادة تعيين UTC.
GET /api/v1/providers: مقدمي المتاحة لهذا المفتاح.
POST /api/v1/tests: إنشاء اختبار. تحتوي الاستجابة 202 على الرمز المميز وsend_to وresults_url.
GET /api/v1/tests: قم بإدراج اختباراتك باستخدام المؤشر والحد من ترقيم الصفحات.
GET /api/v1/tests/:token: اقرأ المواضع والمصادقة والتشخيصات وعناوين URL المتاحة للشاشة.
DELETE /api/v1/tests/:token: حذف الاختبار والنتائج ولقطات الشاشة نهائيًا.
GET /api/v1/monitoring/domains: قم بإدراج نطاقاتك المراقبة ومشاركتها مع موقع الويب وTelegram.
POST /api/v1/monitoring/domains: أضف نطاقك: {"domain": "example.com"}.
POST /api/v1/monitoring/domains/:id/pause: قم بإيقاف مراقبة نطاقك مؤقتًا.
POST /api/v1/monitoring/domains/:id/resume: استئناف مراقبة المجال الخاص بك.
DELETE /api/v1/monitoring/domains/:id: قم بإزالة المجال الخاضع للمراقبة.
GET /api/v1/account/promo-requests: اقرأ طلبات الحزمة المجانية الخاصة بك باستخدام الحساب:قراءة.

الطبقات الافتراضية

يمكن للمشغلين تجاوز المفاتيح الفردية. استخدم دائمًا قيم API للحدود الفعلية.

الطبقة	في اليوم الواحد	في الشهر	لقطات الشاشة
basic	100	1,000	—
pro	500	10,000	متضمنة
enterprise	5,000	100,000	متضمنة

العقدة / بايثون

لا يلزم وجود SDK منفصل. احتفظ بالمفتاح في متغير بيئة سري، وليس في التحكم بالمصادر أبدًا.

العقدة (الجلب)

const response = await fetch('https://check.live-direct-marketing.online/api/v1/me', {
  headers: { Authorization: 'Bearer ' + process.env.ICP_KEY }
});
if (!response.ok) throw new Error('HTTP ' + response.status);
console.log(await response.json());

بايثون (الطلبات)

import os, requests
response = requests.get(
    'https://check.live-direct-marketing.online/api/v1/me',
    headers={'Authorization': 'Bearer ' + os.environ['ICP_KEY']},
    timeout=30,
)
response.raise_for_status()
print(response.json())

التوافق

يظل الإصدار 1 الحالي من اختبار CRUD والقوائم المسموح بها للموفرين وميزات لقطات الشاشة والحصص لكل مفتاح مدعومًا. يؤدي تسجيل الدخول إلى الحساب والمفاتيح الجديدة القابلة للاسترداد وسجل الطلبات وطلبات الحزمة المجانية إلى تمديد API دون تغيير المفاتيح الموجودة.