ASH MAIL / DEVELOPERS / API v1

مرجع API للمطورين

فحص طلب البريد من موقعك بمفتاح خاص بحسابك وسجل طلبات حقيقي. هذه الخدمة لا ترسل بريدًا ولا تمنح اشتراكًا تشغيليًا.

فحص الطلبات متاح في النسخة الحالية

الرابط أدناه يعمل على الموقع العام بعد نشر هذه النسخة. إرسال العملاء غير مفعّل؛ لا توجد حزمة SDK منشورة.

افحص التكامل قبل الإرسال

01 — سجّل الدخول وأنشئ مفتاح فحص في حسابك.
02 — خزّنه في إعدادات خادم موقعك.
03 — أرسل طلب POST مع بيانات الرسالة.
04 — راجع النتيجة وسجل الطلبات في لوحة العملاء.

POST /api/public/v1/emails/validate

// على خادم موقعك فقط؛ لا تضع المفتاح في المتصفح
const response = await fetch("https://ash-mail.com/api/public/v1/emails/validate", {
  method: "POST",
  headers: {
    "Authorization": "Bearer " + process.env.ASH_MAIL_API_KEY,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
  "from": "sender@example.com",
  "to": [
    "recipient@example.com"
  ],
  "subject": "تأكيد الطلب",
  "html": "<p>تم استلام طلبك.</p>"
})
});
const result = await response.json();
if (!response.ok) throw new Error(result.error);
// result.sent === false — فحص فقط، وليس إرسالًا

فحص فقط — لن يتم إرسال أي رسالة

الاستجابات والأخطاء

الحالة	المعنى
200	تم فحص البيانات؛ sent: false. حالة النطاق لا تعني تفعيل إرسال.
401	المفتاح غير صحيح أو ملغى.
413	حجم الطلب يتجاوز 100,000 بايت.
415	استخدم Content-Type: application/json.
422	بيانات غير صالحة؛ راجع fields.
503	الخدمة أو حفظ السجل غير متاح؛ لم يُرسل بريد.

{
  "valid": true,
  "sent": false,
  "sending_enabled": false,
  "domain_status": "domain_pending"
}

حماية حسابك

تظهر قيمة المفتاح مرة واحدة، ويُحفظ إثباته المشفّر فقط. الإلغاء يمنع طلباته الجديدة.

نطاقات منفصلة

فحص النطاق مرتبط بحساب صاحب المفتاح؛ حفظ النطاق ليس إثبات ملكية ولا تصريح إرسال.

سلة وزد

الربط غير متاح بعد. نحتاج تطبيقًا مسجلًا وصلاحيات معتمدة وتجربة تثبيت على متجر حقيقي.

المواقع والمتاجر