التوثيق

ابدأ من هنا

أدلة

شروحات أطول، تتضمّن حالات الفشل: ماذا تفعل لا ماذا يعني كل معامل.

كل الأدلة ←

الأمور الأربعة الجديرة بالمعرفة

صندوق البريد لا يُنشأ

لا توجد استدعاء بعنوان «إنشاء عنوان». يبدأ وجود العنوان لحظة وصول البريد إليه، ويتوقف وجوده عند انتهاء صلاحية آخر رسالة.

العنوان هو بيانات الاعتماد

على نطاق عام، يستطيع أي شخص يعرف العنوان قراءته — عبر API تماماً كما عبر الموقع. استخدم نطاقك الخاص عندما لا يكون ذلك مقبولاً.

كل شيء تنتهي صلاحيته

تُحذف الرسائل بعد 5 يومًا من وصولها. expires_at موجود في كل رسالة فلن تحتاج لحسابه.

استقبال فقط

لا توجد نقطة نهاية ترسل بريداً. هذا مقصود: فهو ما يمنع خدمة مجانية وغير موثَّقة من أن تتحول إلى مُرحِّل للرسائل المزعجة.

عندما يحدث خطأ ما

إذا تصرّف استدعاء بشكل مختلف عن هذا التوثيق، فالتوثيق هو الخطأ — أخبرنا وسيُصلَح.

البريد لا يصل أبدًا

تحقق أولاً من سجل MX: smtp.grabmail.io وليس غيره. أي سجل MX متبقٍ من مزود سابق يأخذ جزءًا من حركة بريدك دون أن تلاحظ.

يجيب API بالرمز 404

إما أن النطاق غير موجّه إلى هنا، أو أن الرسالة تجاوزت فترة الاحتفاظ بها. تُميَّز الحالتان بواسطة رمز error.

البريد يدّعي أنه منّا

إنه مزوَّر. لا شيء هنا يمكنه إرسال بريد — سجل SPF لدينا هو v=spf1 -all وسجل DMARC لدينا هو p=reject، وهو ما يُخبر كل خادم استقبال على وجه الأرض بتجاهله.