راه‌اندازی حساب

ایجاد حسابکپی پیوند بخش

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 نیز نامیده می‌شود) دارد. فضاهای کاری دامنه‌ها، اعتبارنامه‌ها، قالب‌ها و داده‌های ارسال شما را از هم جدا می‌کنند.

چه زمانی از چند فضای کاری استفاده کنیمکپی پیوند بخش

• محیط‌های جداگانه: production در مقابل staging
• محصولات جداگانه: اگر چندین اپلیکیشن دارید که ایمیل ارسال می‌کنند
• مشتریان جداگانه: اگر آژانسی هستید که ایمیل چندین مشتری را مدیریت می‌کنید

تغییر فضای کاریکپی پیوند بخش

از توکن دسترسی خود برای جابجایی بین فضاهای کاری استفاده کنید. 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 و غیره).

فعال‌سازی ۲FAکپی پیوند بخش

۱. POST /v1/auth/2fa/setup را فراخوانی کنید تا یک TOTP secret و QR code URI دریافت کنید ۲. QR code را با اپلیکیشن احراز هویت خود اسکن کنید ۳. راه‌اندازی را با ارسال یک کد معتبر از طریق 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: ایجاد اعتبارنامه برای ارسال ایمیل
• افزودن دامنه: ثبت دامنه ارسال شما
• شروع سریع: ارسال اولین ایمیل