ما هي؟
الواجهة البرمجية العامة لهيو ميل. ترسل خوادمك البريد التشغيلي، وتقرأ سجل الرسائل، وتزامن جهات الاتصال والتحويلات بـJSON عبر HTTPS.
أرسل البريد التشغيلي، واقرأ أحداث التسليم، وزامن جهات الاتصال والطلبات من أنظمتك عبر api.hyonova.com.
الواجهة البرمجية العامة لهيو ميل. ترسل خوادمك البريد التشغيلي، وتقرأ سجل الرسائل، وتزامن جهات الاتصال والتحويلات بـJSON عبر HTTPS.
للمطورين الذين يرسلون الإيصالات والتأكيدات وتنبيهات الحسابات من منتجاتهم، وللفرق التي تزامن جهات الاتصال من نظام آخر.
الواجهة مشمولة في كل الخطط، وكل رسالة تستهلك رصيد بريد واحداً، ولا تفرض خطتك حصة شهرية ولا سقفاً يومياً.
POST /mail/v1/send يضع رسالة واحدة في الطابور من قالب بمتغيرات أو من موضوع وHTML، ويرد بـ202 مع معرّف الرسالة.
GET /mail/v1/messages يعرض الرسائل من الأحدث، مع تصفية بالحالة أو المستلم أو الوسم أو التاريخ وتقسيم الصفحات بالمؤشر.
GET /mail/v1/messages/{id} يعيد الرسالة مع أحداث تسليمها.
GET وPOST على /mail/v1/contacts لعرض جهات الاتصال وإنشاء جهة أو تحديثها بالبريد مع موافقتها.
POST /mail/v1/conversions يسجّل طلباً أو تحويلاً آخر لإسناده إلى الحملات.
GET /mail/v1/forms يعرض نماذج الاشتراك الفعّالة لديك.
GET /mail/v1/me يعيد الشركة وصلاحيات المفتاح وحدودك.
GET /mail/v1/openapi.json يعيد وثيقة OpenAPI 3.0 دون مفتاح.
وثّق نطاقك (DKIM وSPF وDMARC) وأضف مُرسِلاً في هيو ميل، ومن دونه ترفض الواجهة الإرسال برمز 409.
من البريد › الأتمتة › مفاتيح API فعّل صلاحية الإرسال وانسخ المفتاح. يبدأ بـhnm_ ويُعرض مرة واحدة.
أرسل طلب POST إلى https://api.hyonova.com/mail/v1/send مع مفتاحك بصيغة Bearer، والمستلم، وقالب أو HTML.
أرسل مفتاح تكرار آمن مع الطلب، فتكراره يعيد النتيجة الأولى بدل الإرسال مرتين.
أخطاء JSON برمز ومعرّف طلب، وحالات HTTP قياسية، مثل 402 حين تنفد الأرصدة.
كل رد يبيّن الحد وعدد الطلبات المتبقية ووقت تجدد الحد.
الرسالة التي ترفضها خدمة البريد نهائياً يُعاد رصيدها.
صلاحية للإرسال، وأخرى لقراءة الأحداث، واثنتان لقراءة جهات الاتصال وكتابتها، وواحدة لتسجيل التحويلات، وصلاحية خاصة بإضافة WordPress. أسماؤها الدقيقة في المرجع.
يرد الإرسال برمز 402 ولا يُوضع شيء في الطابور. أضف أرصدة وأرسل مجدداً بمفتاح تكرار جديد.
نعم. أرسل عنواناً وHTML بدل معرّف القالب، ويُزال المحتوى غير الآمن.
اقرأها عبر GET /mail/v1/messages/{id}، أو اشترك في Webhooks التسليم والارتداد.
ابدأ مجاناً، ووثّق نطاقك، وأنشئ أول مفتاح API.