واجهة المطورين من VookMail

أنشئ صناديق بريد مؤقتة واقرأ الرسائل من تطبيقاتك عبر واجهة REST بسيطة. الردود بصيغة JSON.

المصادقة

أرسل مفتاح API في ترويسة Authorization. يصدر مالك الموقع المفاتيح.

curl https://www.vookmail.com/api/v1/domains \
  -H "Authorization: Bearer vk_your_key"

نقاط الوصول

الرابط الأساسي: https://www.vookmail.com/api/v1

الطريقة	المسار	الوصف
GET	/domains	عرض النطاقات المتاحة
POST	/mailboxes	إنشاء صندوق. المحتوى: اسم المستخدم والنطاق، وكلاهما اختياري
GET	/mailboxes/{address}	تفاصيل الصندوق وموعد انتهائه
POST	/mailboxes/{address}/extend	تمديد مدة الصندوق
DELETE	/mailboxes/{address}	إغلاق الصندوق وحذف رسائله
GET	/mailboxes/{address}/messages?after={id}	عرض الرسائل مع الأكواد والروابط المكتشفة
GET	/mailboxes/{address}/messages/{id}	قراءة رسالة واحدة: HTML منقّى ونص ومرفقات
DELETE	/mailboxes/{address}/messages/{id}	حذف رسالة واحدة
GET	/mailboxes/{address}/messages/{id}/attachments/{attachment}	تنزيل مرفق

مثال

curl -X POST https://www.vookmail.com/api/v1/mailboxes \
  -H "Authorization: Bearer vk_your_key" \
  -H "Content-Type: application/json" \
  -d '{"username":"myapp"}'

{"address":"myapp@example.com","token":"...","expires_at":"2026-10-31T12:00:00+00:00"}

الأخطاء والحدود

تعيد الأخطاء حالة HTTP مع error.code و error.message. لكل مفتاح حد في الدقيقة، وتجاوزه يعيد الحالة 429.