البدء السريع

من لا شيء إلى رسالة تُقرأ عبر HTTP، في أربعة أوامر. بلا حساب، بلا مفتاح، بلا SDK.

1. اختر عنوانًا

أي اسم، على أي من نطاقاتنا العامة. لا شيء لاستدعائه ولا شيء للتسجيل — يصبح العنوان حقيقيًا لحظة تسليم شيء إليه.

اجعله غير قابل للتخمين إن كنت تفضّل ألا يتجول فيه أحد: على نطاق عام، العنوان هو الشيء الوحيد الفاصل بين صندوق البريد والعالم.

shell

$ ADDR="ci-$(openssl rand -hex 4)@grabmail.io"; echo "$ADDR"

2. أرسل إليه شيئًا

استخدمه في نموذج التسجيل، أو تدفق إعادة تعيين كلمة المرور، أو أيًّا ما كنت تختبره. التسليم عادةً في غضون ثوانٍ قليلة.

تقبل خوادم بريدنا رسائل حتى 5 MB. أي شيء أكبر يُرفَض وقت SMTP، فيُخبَر المُرسِل فورًا بدلًا من تركه في حيرة.

shell

$ curl -sX POST https://your-app.example/signup --data-urlencode "email=$ADDR"

3. استطلع صندوق البريد

طلب واحد في الثانية هو الإيقاع المقصود ولا يُقيَّد أبدًا. صندوق البريد الفارغ يجيب بـ200 مع count: 0 — أبدًا 404، فلا تحتاج حلقتك إلى معاملته كحالة خاصة.

تتوقف هذه المقتطفة بعد دقيقة بدلًا من الدوران إلى الأبد، وهذا ما تريده في CI.

استعلم بشكل متكرر حتى وصولها

$ for i in $(seq 60); do
  ID=$(curl -sG https://grabmail.io/api/v1/mailbox --data-urlencode "address=$ADDR" | jq -r '.messages[0].id // empty')
  [ -n "$ID" ] && break
  sleep 1
done; echo "$ID"

4. اقرأها ثم تخلَّص منها

اجلب الرسالة واستخرج منها ما جئت من أجله — هنا، رمز مكوَّن من ستة أرقام من الجزء النصي العادي.

الحذف اختياري: كل شيء يزول من تلقاء نفسه بعد 5 يومًا. افعله على أي حال في CI، وتبدأ الجولة التالية من صندوق بريد نظيف.

القراءة والحذف

$ curl -sG https://grabmail.io/api/v1/message/$ID --data-urlencode "mailbox=$ADDR" \
  | jq -r .text | grep -oE '[0-9]{6}'

curl -sX DELETE -G https://grabmail.io/api/v1/message/$ID --data-urlencode "mailbox=$ADDR"

إذا رُفض العنوان

يحدث هذا، وليس عطلًا. النطاقات العامة مدرجة في القوائم السوداء العامة للبريد المؤقت، ونسبة كبيرة من نماذج التسجيل تراجعها. تغيير الجزء الذي يسبق @ لا يفيد — المرفوض هو النطاق.

وجّه نطاقك الخاص إلينا وتختفي المشكلة مجانًا: اربط نطاقًا. وإن كنت تفضّل عدم استخدام نطاق خاص بك، تفتح الخطة المدفوعة 92 نطاقًا .com خاصًا، خارج تلك القوائم — نفس النداءات الأربعة، مع ترويسة Authorization: Bearer. عرض الخطط.

دمجه في CI

عادتان تحافظان على مجموعة اختبارات تقرأ بريدًا حقيقيًا من أن تصبح غير مستقرة:

عنوان جديد لكل تشغيل: اشتقّه من معرّف البنية أو من لاحقة عشوائية. إعادة استخدام عنوان واحد عبر التشغيلات المتكررة تعني أن رسالة الأمس قد تُرضي اختبار اليوم.
مهلة زمنية، لا عدّاد محاولات: استطلع مقابل مهلة زمنية فعلية كما سبق. عدد المحاولات يزداد بصمت كلما تباطأ المرسل.
لا تعتمد أبداً على وقت التسليم: البريد ليس متزامنًا. تأكّد من أن الرسالة تصل، لا أنها تصل خلال ثانية محددة.
استخدم نطاقك الخاص لأي أمر حقيقي: صندوق البريد العام يمكن لأي شخص يخمّن العنوان قراءته — والنطاقات العامة مطبوعة على هذا الموقع، لذا فهي مخمَّنة بالفعل. أما على نطاق خاص بك، فلا يمكن لأحد أن يجد العنوان إلا إذا كان يعرفه بالفعل. سجل MX واحد، ولا شيء آخر لتفعله.

لوكلاء الذكاء الاصطناعي: MCP

لا يستطيع الوكيل قراءة هذه الصفحة، وتحديد النقطة الطرفية التي يريدها، وكتابة طلب. بل يسأل خادمًا عن الأدوات الموجودة ويستدعيها. يشغّل grabmail خادم بروتوكول سياق النموذج (Model Context Protocol) لهذا الغرض بالضبط، على https://grabmail.io/mcp — بلا مفتاح، بلا حساب.

وجّه أي عميل MCP إلى النقطة الطرفية. يقرأ Claude Desktop وCursor وContinue وOpenAI Agents SDK جميعًا هذا الشكل.

ست أدوات: create_inbox وlist_domains وlist_messages وread_message وdelete_message وwait_for_message.

mcp.json

$ {"mcpServers":{"grabmail":{"url":"https://grabmail.io/mcp"}}}

wait_for_message هي التي تهم. السبب الذي يجعل الوكيل يريد صندوق بريد مؤقت هو غالبًا رمز تأكيد يقف بينه وبين الخطوة التالية. فبدلًا من الاستطلاع في حلقة تستهلك رموزًا (tokens)، يطلب عنوانًا، يرسل النموذج، وينتظر حتى تصل الرسالة:

ينتظر حتى 25 ثانية ويعيد الرسالة كاملة — المُرسِل، الموضوع، المتن — أو يقول إنه انتهت مهلته حتى يستطيع الوكيل ببساطة الاستدعاء مرة أخرى.

يمكنه أيضًا انتظار رسالة معينة: مرّر subject_contains أو from_contains ويُتجاهَل أي شيء آخر يصل.

MCP · wait_for_message

$ curl -sX POST https://grabmail.io/mcp -H "Content-Type: application/json" -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"wait_for_message","arguments":{"address":"you@grabmail.io","subject_contains":"code"}}}'

توجد أيضًا مواصفة OpenAPI 3.1 (YAML) لمولدات الأكواد، وllms.txt لكل ما يفضّل قراءة نص عادي.

مرجع API

كل معلمة، كل رمز حالة، وشكل الخطأ.

افتح المرجع ←

الحدود

ما هو مسقوف، وما ليس كذلك، وما يحدث عند بلوغ السقف.

افتح الحدود ←

نطاقك الخاص

سجل MX واحد، ويعمل كل عنوان على نطاقك هنا — لا حاجة لتسجيل أي شيء.

اطّلع على الإعداد ←