متاح

واجهة هيو ميل البرمجية (REST API)

أرسل البريد التشغيلي، واقرأ سجل الرسائل، وزامن جهات الاتصال والطلبات من أنظمتك بمفاتيح API.

حملة بريدية تُرسل إلى جهات الاتصال، مع رسم بياني للنتائج.

ماذا يفعل

  • POST /mail/v1/send يضع رسالة تشغيلية واحدة في الطابور لكل طلب، من قالب في هيو ميل مع متغيرات أو من HTML خاص بك.

  • قراءة سجل الرسائل وأحداث تسليم كل رسالة.

  • إنشاء جهات الاتصال أو تحديثها مع موافقتها، وعرض جهات الاتصال ونماذج الاشتراك الفعّالة.

  • تسجيل الطلبات والتحويلات الأخرى لإسنادها إلى الحملات، مع وثيقة OpenAPI 3.0 منشورة على /mail/v1/openapi.json.

لمن

للمطورين الذين يريدون إرسال الإيصالات والتأكيدات وتنبيهات الحسابات من منتجاتهم عبر هيو ميل.

طريقة الربط

  1. وثّق نطاق الإرسال وأضف مُرسِلاً في هيو ميل.

  2. أنشئ مفتاح API من البريد › الأتمتة › مفاتيح API، بالصلاحيات التي يحتاجها فقط.

  3. اتصل بـhttps://api.hyonova.com مع الترويسة Authorization: Bearer ومفتاحك.

  4. أرسل Idempotency-Key مع كل إرسال، حتى لا تُرسل الرسالة نفسها مرتين عند إعادة المحاولة.

ما تحتاجه

  • مُرسِل موثّق على نطاقك الخاص.

  • أرصدة بريد: كل رسالة تستهلك رصيداً واحداً.

  • صلاحية إدارة البريد لإنشاء المفاتيح (للمالك والمدير العام افتراضياً). الواجهة مشمولة في كل الخطط.

الحدود

  • هذه واجهة هيو ميل. باستثناء تزويد الأعضاء عبر SCIM في خطة المؤسسات، يُستخدم العمل والعملاء والاجتماعات في HyoNova من تطبيق الويب، لا عبر واجهة برمجية عامة.

  • 600 طلب في الدقيقة لكل مفتاح (300 للتحويلات)، مع ترويسات حدود المعدل في كل رد.

  • لا يوجد ترحيل SMTP، ولا نقاط نهاية للحملات أو القوائم.

  • يُعرض المفتاح مرة واحدة ويُحفظ كبصمة فقط، فاحفظه على خوادمك.

الدليل الكامل: مرجع واجهة البريد البرمجية

جاهز تجرّب HyoNova؟

ابدأ مجاناً حتى 10 أعضاء، بدون بطاقة.