إعداد الحساب

إنشاء حسابنسخ رابط القسم

curl -X POST https://api.mail.land/v1/auth/register \
  -H "Content-Type: application/json" \
  -d '{
    "email": "[email protected]",
    "password": "your-secure-password",
    "fullName": "Jane Doe",
    "companyName": "Acme Inc"
  }'

{
  "requiresEmailVerification": true,
  "verificationTicket": "vt_abc123...",
  "maskedEmail": "y***@company.com"
}

curl -X POST https://api.mail.land/v1/auth/verify-email-ticket \
  -H "Content-Type: application/json" \
  -d '{
    "ticket": "vt_abc123...",
    "code": "482916"
  }'

curl -X POST https://api.mail.land/v1/auth/login \
  -H "Content-Type: application/json" \
  -d '{
    "email": "[email protected]",
    "password": "your-secure-password"
  }'

{
  "userId": "abc123def456",
  "email": "[email protected]",
  "fullName": "Jane Doe",
  "accessToken": "eyJhbGciOiJIUzI1NiIs...",
  "refreshToken": "rt_abc123...",
  "expiresAt": "2026-02-17T11:30:00Z",
  "tenantCount": 1,
  "activeTenantId": "k3m9x2p7qw4rtz",
  "activeTenantName": "Acme Inc"
}

مساحات العمل (Tenants)نسخ رابط القسم

يحتوي كل حساب في MailLand على مساحة عمل واحدة على الأقل (تُعرف أيضاً بـ Tenant). تعزل مساحات العمل النطاقات والاعتمادات والقوالب وبيانات الإرسال الخاصة بك.

متى تستخدم مساحات عمل متعددةنسخ رابط القسم

• بيئات منفصلة: الإنتاج مقابل بيئة التطوير
• منتجات منفصلة: إذا كنت تدير تطبيقات متعددة ترسل بريداً إلكترونياً
• عملاء منفصلون: إذا كنت وكالة تدير البريد الإلكتروني لعملاء متعددين

التبديل بين مساحات العملنسخ رابط القسم

استخدم رمز الوصول للتبديل بين مساحات العمل. tenantId هو المعرّف النصي العام لمساحة العمل، احصل على المعرّفات من GET /v1/account/tenants:

curl -X POST https://api.mail.land/v1/account/tenants/switch \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..." \
  -H "Content-Type: application/json" \
  -d '{
    "tenantId": "k3m9x2p7qw4rtz"
  }'

يُعيد هذا الطلب رمز وصول جديداً مقيداً بمساحة العمل المحددة.

المصادقة الثنائيةنسخ رابط القسم

يدعم MailLand المصادقة الثنائية المبنية على TOTP (متوافقة مع Google Authenticator وAuthy و1Password وغيرها).

تفعيل المصادقة الثنائيةنسخ رابط القسم

1. استدعِ POST /v1/auth/2fa/setup للحصول على سر TOTP ورمز QR
2. امسح رمز QR بتطبيق المصادقة الخاص بك
3. أكّد الإعداد بإرسال رمز صالح عبر POST /v1/auth/2fa/enable

بعد التفعيل، سيتطلب كل تسجيل دخول رمزاً مكوناً من ٦ أرقام من تطبيق المصادقة.

مصادقة APIنسخ رابط القسم

يستخدم MailLand طريقتين للمصادقة:

رموز Bearer (لوحة التحكم وإدارة الحساب)نسخ رابط القسم

لعمليات الحساب (تسجيل الدخول وإدارة مساحات العمل والإعدادات)، استخدم رموز JWT bearer في ترويسة Authorization:

Authorization: Bearer eyJhbGciOiJIUzI1NiIs...

تنتهي صلاحية الرموز بعد المدة المحددة في expiresAt. استخدم POST /v1/auth/refresh-token للحصول على رمز جديد قبل انتهاء الصلاحية.

مفاتيح API (عمليات البريد الإلكتروني)نسخ رابط القسم

لإرسال البريد الإلكتروني وإدارة النطاقات وجميع استدعاءات API التشغيلية، استخدم مفاتيح API في ترويسة X-API-Key:

X-API-Key: ml_pet_Ab3Kx9mN2pQ7rT4wL8yD...

تكون مفاتيح API مقيدة بمساحة عمل ولا تنتهي صلاحيتها ما لم تحدد تاريخ انتهاء. راجع API Keys للاطلاع على تفاصيل إنشاء الاعتمادات وإدارتها.

الخطوات التاليةنسخ رابط القسم

• API Keys: إنشاء اعتمادات لإرسال البريد الإلكتروني
• إضافة نطاق: تسجيل نطاق الإرسال الخاص بك
• البدء السريع: إرسال أول بريد إلكتروني