الحدود
كل ما هو محدود، في مكان واحد. مُعلَن لا مُكتَشَف — أي حد تصادفه بلا سابق إنذار هو خلل في التوثيق.
نظرة سريعة
1–5/ثانية
طلبات API لكل عنوان
واحد بلا مفتاح؛ و2 أو 3 أو 5 بمفتاح من خطة مدفوعة. والاستطلاع مرة كل ثانية هو النمط المقصود.
60/دقيقة
طلبات API المجانية في الدقيقة
لكل عنوان IP، بلا مفتاح. والخطط المدفوعة بلا سقف في الدقيقة.
1,000/يوم
طلبات API المجانية في اليوم
لكل عنوان IP، ويُصفَّر العدّ عند 00:00 UTC. والخطط المدفوعة بلا سقف يومي.
5أيام
مدة الاحتفاظ بالرسائل
من لحظة الوصول، قُرئت أم لا. حدّ صارم.
5MB
الحجم الأقصى للرسالة
يُرفض وقت SMTP، ليتم إبلاغ المرسل.
∞
عدد العناوين لكل نطاق
لا شيء يُنشأ مسبقاً، وبالتالي لا شيء يُحتسب.
200
عدد الرسائل المُعادة في كل استدعاء
الافتراضي 50. هذا يحدّ استجابة واحدة، لا صندوق البريد نفسه:
nextيتنقّل عبر الباقي، مهما كان عدده.0
الرسائل الصادرة
لا توجد نقطة نهاية للإرسال. بالتصميم.
حدود المعدل
مجانًا وبلا مفتاح: الطلبات حتى 60 في الدقيقة و1,000 في اليوم، لكل عنوان IP. يُحتسب كل نداء على صندوق البريد — سرده، وقراءة رسالة، ونصها بصيغة HTML، ومرفق، والحذف — وكذلك كل استدعاء لأداة MCP. ويُصفَّر العدّ اليومي عند 00:00 UTC.
وضمن ذلك، قراءة واحدة في الثانية لكل عنوان: استطلاع صندوق البريد مرة كل ثانية هو الإيقاع المقصود.
مع مفتاح API مجاني، تتبع الحصة نفسها حسابك بدلًا من عنوان IP الخاص بك — وهذا مفيد عندما تصدر استدعاءاتك من عناوين متغيرة، مثل مشغّل CI. للحساب المجاني مفتاح واحد، والصناديق التي يقرأها تُدرج في صناديقك. إنشاء مفتاح مجاني
الخطط المدفوعة بلا سقف في الدقيقة وبلا سقف يومي. أرسل مفتاح خطة مدفوعة كـ Authorization: Bearer فلا يبقى إلا معدل الخطة لكل عنوان — 2 أو 3 أو 5 طلبات في الثانية، على كل النطاقات، ويُحتسب لكل حساب على حدة. وتبدأ خطة Premium من $12.99 شهريًا. عرض الخطط
صندوق الوارد على هذا الموقع لا يستهلك من الحصة المجانية لواجهة API: فالصفحة التي تتركها مفتوحة تواصل التحقق من وصول البريد ما دمت تحتاج إليها.
عند تجاوز أحد الحدود تحصل على 429 مع ترويسة Retry-After بالثواني الصحيحة: rate_limited لحد الدقيقة أو حد العنوان، وdaily_limit_reached لحد اليوم، مع الوقت المتبقي حتى منتصف الليل بتوقيت UTC. وتُبيّن كل استجابة مجانية ما تبقّى لك: X-RateLimit-Remaining للدقيقة، وX-RateLimit-Daily-Remaining لليوم.
HTTP/1.1 429 Too Many Requests
Retry-After: 3600
X-RateLimit-Daily-Limit: 1000
X-RateLimit-Daily-Remaining: 0
Content-Type: application/json
{
"error": "daily_limit_reached",
"message": "free daily limit reached: 1000 requests a day per IP address, resets at 00:00 UTC — paid plans have no daily cap",
"upgrade": { "from": "$12.99/month", "url": "https://grabmail.io/pricing", … }
}تراجع بناءً على Retry-After بدلًا من فترة انتظار ثابتة. إذا تغيّر الحد يومًا ما، يستمر الكود الذي يقرأ الترويسة في العمل.
حجم الرسالة
رسائل حتى 5 MB، بما في ذلك المرفقات. يُفرض هذا الحد الأقصى من قِبل خادم البريد أثناء محادثة SMTP، وهذا مهم: يُخطَر الخادم المُرسِل لحظة المحاولة، فيُبلّغ مستخدمه بفشل حقيقي، بدلاً من أن تختفي الرسالة.
- ما يُحتسب
- الرسالة المُرمَّزة كاملة — الترويسات والمتن وكل مرفق بعد ترميز MIME. يُضخّم base64 الملف الثنائي بنحو الثلث، فيملأ ملف بحجم 3.5 MB تقريبًا السقف بالفعل.
- ما يحدث عبر الخط
- رمز
552وقت اتصال SMTP. لا تُخزَّن الرسالة أبدًا ولا تظهر في صندوق البريد. - المرفقات لكل رسالة
- عشرون. سقف الحجم هو ما تصادفه أولاً في الواقع العملي — لكن الرسالة التي تحمل أكثر من عشرين جزءًا بأسماء ملفات تحتفظ بالعشرين الأولى فقط.
الاحتفاظ
تُحذف الرسالة بعد 5 يومًا من وصولها، سواء قُرئت أم لا، وتبدأ العدّاد من لحظة التسليم لا من لحظة أول قراءة.
تحمل كل رسالة الحقل expires_at، فلا يحتاج العميل أبدًا إلى حساب ذلك التاريخ أو تتبّع السياسة.
إنه حدّ صارم لا إعداد: لا معامل ولا خطة ولا حساب يمدّده. إن كان لا بد أن يبقى شيء بعد هذه المدة، فاجلبه واحفظه لديك.
العناوين والنطاقات
- عدد العناوين لكل نطاق
- غير محدود، وغير مُحصى. بما أن الصندوق لا يُنشأ أبدًا، فلا توجد قائمة به لتكبر.
- قواعد الجزء المحلي
- من حرف واحد إلى 64 حرفاً: أحرف، أرقام، نقطة، شرطة، شرطة سفلية وعلامة زائد. يجب أن يبدأ وينتهي بحرف أو رقم. يُرفض أي شيء آخر قبل وصوله إلى خادم البريد، في المتصفح ثم مرة أخرى على الخادم.
- العنونة بعلامة الجمع
name+tag@domainصندوق بريد مستقل هنا، وليس اسمًا بديلًا لـname@domain. هذا مقصود — العلامات (tags) هي الطريقة التي يفصل بها الناس بين عمليات التسجيل، ودمجها كان سيدمج صناديق بريد كان المقصود منها أن تبقى منفصلة.- حالة الأحرف
- كل شيء يُكتب بأحرف صغيرة.
Name@وname@هما نفس صندوق البريد. - نطاقات مخصصة
- لا حد لعدد النطاقات التي يمكنك توجيهها إلى هنا. يحتاج كل نطاق إلى سجل MX خاص به.
الاستخدام العادل
لا توجد حصة يمكن شراء تجاوزها، ولا خطة ترفع هذه الأرقام. الموجود بدلًا من ذلك: إذا جعل مصدر واحد الخدمة أسوأ للجميع، يُوقَف.
- الاستطلاع الجماعي
- آلاف صناديق البريد المُستطلَعة كل ثانية من مصدر واحد سيُحدّ منها عند الحافة قبل أن تصل إلى API.
- فيضانات البريد
- المضيف المُرسِل الذي يفتح عددًا غير معقول من اتصالات SMTP يُحجَز لمدة عشر دقائق. المرسلون العاديون لا يقتربون من ذلك أبدًا.
- استخدامنا كمُرحِّل
- مستحيل لا ممنوع: خادم البريد يقبل فقط الرسائل الموجَّهة إلى نطاقات مستضافة هنا، فلا يمكنه إعادة توجيه أي شيء إلى أي مكان.
لا شيء من هذا موجّه للأتمتة العادية. استطلاع مرة كل ثانية، طوال اليوم، عبر آلاف الصناديق البريدية — هذا هو الاستخدام المقصود، لا حدّه الأقصى.