Rasel Mailقراءة المجلدات والرسائل والمرفقات
مرجع نقاط القراءة وحدود الصندوق والمجلد والـUID.
آخر تحديث تحريري: ٣٠ أكتوبر ٢٠٢٦في هذا الدليل
ابدأ بالصندوق المسموح
الصندوق المتاح للرمز
curl -i 'https://raselmail.com/api/v1/oauth/mailboxes' -H "Authorization: Bearer $RASEL_ACCESS_TOKEN"النتيجة مصفوفة تتضمن mailbox_id وemail وscopes وauthorization_id وتواريخ الربط والاستخدام. استخدم mailbox_id المعاد، ولا تفترض أن الرمز يسمح بكل صناديق المالك.
نقاط القراءة
| GET path | النتيجة |
|---|---|
| /api/v1/oauth/mailboxes/{id}/folders | مجلدات الصندوق المسموح. |
| /api/v1/oauth/mailboxes/{id}/messages | قائمة الرسائل؛ folder وsearch وbefore. |
| /api/v1/oauth/mailboxes/{id}/messages/{uid} | جسم الرسالة وبيانات المرفقات؛ حدد folder. |
| /api/v1/oauth/mailboxes/{id}/messages/{uid}/attachments/{index} | بيانات الملف مباشرة، وليست JSON. |
الصفحات والهوية
قائمة الرسائل ترجع items وnext. مرر next كما هو في before للصفحة التالية حتى يصبح فارغًا. before عدد موجب عند وجوده، وsearch حتى 100 محرف، وfolder حتى 200. المجلد الافتراضي INBOX. UID يخص مجلدًا في صندوق؛ لا تستخدم رقمًا من Sent لقراءة رسالة في INBOX.
مثال قائمة الوارد
curl -G -i 'https://raselmail.com/api/v1/oauth/mailboxes/YOUR_MAILBOX_ID/messages' -H "Authorization: Bearer $RASEL_ACCESS_TOKEN" --data-urlencode 'folder=INBOX' --data-urlencode 'search=invoice'التعامل مع المحتوى
اعتبر HTML الوارد محتوى غير موثوق. لا تحقنه في صفحات تطبيقك بدون عزل وتنقية، ولا تطلب صورًا بعيدة تلقائيًا باسم المستخدم دون سياسة خصوصية واضحة. احفظ الملفات بأسماء آمنة، واقرأ نوع المحتوى قبل المعاينة.