لدى InboxWarm API عامة لإحماء البريد الإلكتروني
أتمتة الإحماء، واستخراج بيانات قابلية التسليم، وإدارة كل صندوق بريد برمجيًا — 27 نقطة نهاية REST، متضمنة مع كل خطة.
آخر تحديث:
TL;DR
تمتلك InboxWarm واجهة REST API عامة تضم 27 نقطة نهاية موزعة على 5 فئات — حسابات البريد الإلكتروني، الإحماء، قابلية التسليم، التقارير، والنظام. تتيح لك هذه الواجهة ربط صناديق البريد، وبدء الإحماء وإيقافه، واستخراج درجات قابلية التسليم والتقارير إلى أدواتك الخاصة. الوصول متضمن في كل خطة دون أي تكلفة إضافية: أنشئ حسابك، ثم أنشئ مفتاحًا من Developer Kit > API Integration، وأجرِ أول استدعاء لك في أقل من 5 دقائق.
لماذا تستخدم InboxWarm API؟
توجد InboxWarm API لتمكينك من تشغيل إحماء البريد الإلكتروني ومراقبة قابلية التسليم من منتجك الخاص، أو النصوص البرمجية، أو لوحات التحكم الخاصة بك، بدلاً من تطبيق InboxWarm على الويب.
أتمتة بدء الإحماء وإيقافه
ابدأ الإحماء فور تجهيز صندوق بريد جديد، وأوقفه عند إطلاق حملة — دون الحاجة إلى أي نقرات في لوحة التحكم.
استخراج بيانات قابلية التسليم إلى لوحات التحكم الخاصة بك
غذِّ أداة تحليل الأعمال (BI) أو لوحة الإدارة الداخلية لديك مباشرةً بدرجات الإعداد، وصحة DNS، ومعدل الوصول إلى البريد الوارد، وتقارير الإحماء اليومية.
ربط InboxWarm بمنتجك أو أدواتك الداخلية
أدر صناديق البريد برمجيًا من مسار تهيئة المستخدمين لديك، أو نظام CRM، أو النظام الخلفي لوكالتك، باستخدام استدعاءات REST بسيطة.
متضمن في كل خطة، دون أي تكلفة إضافية
تأتي كل خطة من خطط InboxWarm بوصول كامل إلى API دون أي رسوم إضافية — أنشئ مفتاحًا وابدأ باستدعاء نقاط النهاية اليوم.
ماذا يمكنك أن تفعل باستخدام InboxWarm API؟
تغطي واجهة API الخاصة بإحماء البريد الإلكتروني 27 نقطة نهاية REST موزعة على 5 فئات؛ ويتوفر المرجع الكامل لكل نقطة نهاية على حدة في مرجع API العام.
حسابات البريد الإلكتروني
اربط صناديق بريد Gmail أو Microsoft أو SMTP/IMAP، وتحقق من صحة اتصالها، وأدرها واحدًا تلو الآخر أو دفعة واحدة.
الإحماء
ابدأ إحماء البريد الإلكتروني وأوقفه واضبط إعداداته لأي صندوق بريد — بما في ذلك تنفيذ إجراءات جماعية على ما يصل إلى 50 صندوق بريد في استدعاء واحد.
قابلية التسليم
تحقق من درجات الإعداد، وشغّل فحوصات صحة DNS المباشرة (SPF وDKIM وDMARC وMX)، وقِس معدل وصول البريد إلى البريد الوارد مقابل البريد العشوائي لكل مزود.
التقارير
استخرج تقارير الإحماء اليومية، وملخصات لوحة التحكم على مستوى الحساب، وملفات تصدير CSV غير المتزامنة، إلى لوحات التحكم والأدوات الخاصة بك.
النظام
نقاط نهاية لحالة تشغيل الخدمة وحد معدل الطلبات، لتتمكن من مراقبة تكاملك دون استهلاك حصتك من الطلبات.
المرجع الكامل
أمثلة على الطلبات والاستجابات لكل نقطة نهاية، إلى جانب رموز الأخطاء وتفاصيل المصادقة.
تصفّح مرجع APIكيف أبدأ استخدام InboxWarm API؟
يمكنك إجراء أول استدعاء لـ InboxWarm API في أقل من 5 دقائق: أنشئ حسابًا، ثم أنشئ مفتاح API، وأرسل طلب curl واحدًا — دون أي تعقيدات OAuth، ودون الحاجة إلى تثبيت أي SDK.
- 1
أنشئ حساب InboxWarm — التجربة المجانية لمدة 10 أيام لا تتطلب بطاقة ائتمان.
- 2
أنشئ مفتاح API من Developer Kit > API Integration داخل التطبيق.
- 3
استدعِ أي نقطة نهاية — على سبيل المثال، اعرض قائمة حسابات البريد الإلكتروني المتصلة لديك:
curl "https://app.inboxwarm.ai/api/v1/email-accounts?api_key=YOUR_API_KEY"هذا كل شيء — الاستجابة عبارة عن قائمة JSON بصناديق بريدك مع حالة الإحماء الخاصة بكل منها. من هناك، يمكنك بدء الإحماء بطلب POST واحد.
كيف أُصادق مع InboxWarm API؟
تتم مصادقة كل طلب باستخدام مفتاح API الخاص بك؛ ويختلف موضع المفتاح باختلاف طريقة HTTP التي تستخدمها.
معامل الاستعلام
أضف مفتاح API الخاص بك إلى الرابط (URL) كمعامل استعلام باسم api_key.
?api_key=YOUR_API_KEYحقل في جسم JSON
أدرج مفتاح API الخاص بك كحقل باسم apiKey داخل جسم طلب JSON.
{ "apiKey": "YOUR_API_KEY", ... }أنشئ مفاتيح API وأدرها من Developer Kit > API Integration داخل تطبيق InboxWarm. يمنحك كل مفتاح وصولاً كاملاً إلى حسابك عبر جميع نقاط النهاية.
ماذا يمكنك أن تبني باستخدام InboxWarm API؟
تستخدم الفِرق واجهة InboxWarm API الخاصة بقابلية تسليم البريد الإلكتروني لدمج الإحماء ومراقبة صناديق البريد في المنتجات، وخطوط معالجة بيانات BI، وسير عمل الوكالات — وفيما يلي ثلاثة أنماط شائعة.
تشغيل الإحماء من مسار تهيئة المستخدمين لديك
عندما يُجهّز منتجك صندوق بريد إرسال جديدًا لعميل، استدعِ POST /email-accounts لربطه، ثم POST /warmup-settings/{id}/start لبدء الإحماء تلقائيًا — بحيث يبدأ صندوق البريد بالتهيئة قبل أن ينتهي عميلك من عملية الإعداد.
استخراج درجات قابلية التسليم الأسبوعية إلى أداة BI الخاصة بك
جدوِل مهمة أسبوعية تستدعي POST /deliverability-score/{id} وPOST /reports/bulk، ثم أرسل معدلات وصول البريد إلى البريد الوارد مقابل البريد العشوائي إلى Looker أو Metabase أو Google Sheets، بحيث يرى فريقك بأكمله اتجاهات قابلية التسليم جنبًا إلى جنب مع مقاييس الحملات.
مراقبة صناديق بريد العملاء من لوحة تحكم وكالتك
تستخدم الوكالات التي تدير عشرات صناديق بريد العملاء POST /email-accounts/bulk-status وGET /dashboard لعرض أخطاء المصادقة، ودرجات الصحة، وحالات الإحماء في واجهة داخلية واحدة — بالإضافة إلى POST /warmup-settings/bulk-action لإصلاح المشكلات دفعة واحدة.
ما هي حدود معدل الطلبات، وما تكلفة استخدام API؟
الحد الافتراضي لمعدل الطلبات هو 20 طلبًا في الدقيقة لكل مفتاح API، والوصول إلى API متضمن مع كل خطة من خطط InboxWarm دون أي تكلفة إضافية.
20 طلب/دقيقة
الحد الافتراضي لكل مفتاح API. تحقق من استخدامك الحي في أي وقت عبر GET /rate-limit — وهذا الاستدعاء لا يُحتسب ضمن حصتك.
$0 إضافي
الوصول إلى API متضمن في كل خطة — دون وجود مستوى منفصل لـ API، أو رسوم استخدام، أو إضافات مدفوعة. راجع الأسعار.
الأسئلة الأكثر شيوعاً
نعم. تمتلك InboxWarm واجهة REST API عامة تضم 27 نقطة نهاية موزعة على 5 فئات: حسابات البريد الإلكتروني، الإحماء، قابلية التسليم، التقارير، والنظام. وهي متاحة لكل عميل على كل خطة دون أي تكلفة إضافية.
أنشئ حسابًا في InboxWarm (تجربة مجانية لمدة 10 أيام، دون الحاجة إلى بطاقة ائتمان)، ثم افتح Developer Kit > API Integration داخل التطبيق لإنشاء مفاتيح API وإدارتها. يمنحك كل مفتاح وصولاً كاملاً إلى حسابك عبر جميع نقاط النهاية.
يمكنك ربط حسابات البريد الإلكتروني وإدارتها، وبدء الإحماء وإيقافه، وقراءة إعدادات الإحماء، والتحقق من درجات الإعداد وقابلية التسليم، وتشغيل فحوصات صحة DNS، واستخراج تقارير الإحماء اليومية وملخصات لوحة التحكم إلى أدواتك الخاصة.
تستخدم InboxWarm نظام مصادقة مختلطًا يعتمد على طريقة HTTP: ترسل طلبات GET وDELETE مفتاح API كمعامل استعلام باسم api_key، بينما ترسله طلبات POST كحقل باسم apiKey داخل جسم JSON. ولا حاجة إلى أي مسار OAuth.
الحد الافتراضي لمعدل الطلبات هو 20 طلبًا في الدقيقة لكل مفتاح API. يمكنك التحقق من استخدامك الحالي في أي وقت عبر GET /rate-limit — ولا يُحتسب هذا الاستدعاء ضمن حصتك.
الوصول إلى API متضمن في كل خطة من خطط InboxWarm دون أي تكلفة إضافية. لا يوجد مستوى منفصل لـ API، ولا رسوم استخدام، ولا إضافات مدفوعة.
نعم. توفّر InboxWarm مجموعة Postman مزودة بخادم وهمي (mock server) تتيح لك استكشاف كل نقطة نهاية واختبارها قبل كتابة أي كود. ستجدها إلى جانب مفاتيح API الخاصة بك في Developer Kit > API Integration داخل التطبيق.
المرجع الكامل لكل نقطة نهاية من نقاط النهاية الـ 27 متاح للعامة على الرابط https://inboxwarm.ai/api/docs/ — دون الحاجة إلى تسجيل الدخول.
نعم. استخدم POST /warmup-settings/{emailAccountId}/start وPOST /warmup-settings/{emailAccountId}/stop للتحكم في إحماء صندوق بريد واحد، أو POST /warmup-settings/bulk-action لبدء أو إيقاف الإحماء لما يصل إلى 50 صندوق بريد في استدعاء واحد.
نعم. تتضمن API نقاط نهاية جماعية لربط الحسابات (حتى 20 صندوق بريد)، وبدء الإحماء وإيقافه (حتى 50 صندوق بريد)، وحالة الحسابات (حتى 50 صندوق بريد)، وحذف الحسابات (حتى 20 صندوق بريد)، والتقارير اليومية (حتى 50 صندوق بريد لكل طلب).
هل أنت مستعد لأتمتة إحماء بريدك الإلكتروني؟
احصل على مفتاح API الخاص بك في دقائق — 27 نقطة نهاية، وتجربة مجانية لمدة 10 أيام، دون بطاقة ائتمان، مع وصول إلى API متضمن في كل خطة.