واجهة برمجية واحدة لكل ميزات البريد. نقطة الدخول: https://app.bianccamail.workers.dev/api/v1
POST /api/v1/auth/register — {email, password} → {user, accessToken, refreshToken}
POST /api/v1/auth/login — {email, password} → {user, accessToken, refreshToken}
GET /api/v1/auth/me — Bearer token → user context
GET /api/v1/mailboxes — قائمة · POST /api/v1/mailboxes — إنشاء · DELETE /api/v1/mailboxes/:id — حذف
GET /api/v1/mailboxes/:id/messages — قائمة · GET /api/v1/messages/:id?mailboxId= — قراءة · POST /api/v1/messages/:id/read — تعليم كمقروءة
GET /api/v1/billing/plans — كتالوج الخطط الفعلي (الاسم، السعر، المدة، حدود الصناديق، المزايا).
POST /api/v1/inbound/sendgrid?secret=SECRET — {from, to, subject, text} → {ok, id, otpCode}. يُقبل السر أيضاً في الترويسة x-sendgrid-secret.
401 UNAUTHENTICATED · 403 FORBIDDEN/CSRF_MISMATCH · 404 NOT_FOUND · 409 EMAIL_TAKEN/MAILBOX_TAKEN · 422 INVALID_EMAIL/WEAK_PASSWORD · 501 NOT_CONFIGURED
تُطبَّق حدود لكل عنوان IP ولكل حساب على الخادم. راجع حالة الخدمة في GET /api/v1/meta.