MailLandDocs
Başlarken

Hesap Kurulumu

Mail.Land hesabınızı oluşturun, e-postanızı doğrulayın ve ilk çalışma alanınızı kurun

Hesap Oluşturma

Kayıt Olma

Kayıt endpoint'ine bir POST isteği gönderin veya app.mail.land adresindeki gösterge paneli üzerinden kaydolun.

register.sh
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"
  }'

fullName ve companyName alanları isteğe bağlıdır ancak önerilir. Parolanız 8 ile 128 karakter arasında olmalı ve bir büyük harf, bir küçük harf, bir rakam ve bir özel karakter içermelidir.

E-postanızı Doğrulama

Kayıt işleminin ardından MailLand, e-posta adresinize bir doğrulama kodu gönderir. Kayıt yanıtında bir verificationTicket alırsınız:

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

Gelen kutunuzdaki kodu gönderin:

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

Kodu almadıysanız, POST /v1/auth/resend-verification-ticket aracılığıyla yeni bir kod talep edin. Yeniden gönderimler arasında bekleme süresi ve günlük bir sınır uygulanmaktadır.

Giriş Yapma

Doğrulama işleminin ardından erişim jetonunuzu almak için giriş yapın:

login.sh
curl -X POST https://api.mail.land/v1/auth/login \
  -H "Content-Type: application/json" \
  -d '{
    "email": "[email protected]",
    "password": "your-secure-password"
  }'
Login Response
{
  "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"
}

İki faktörlü kimlik doğrulama etkinleştirilmişse, yanıt jeton yerine requiresTwoFactor: true ve bir twoFactorChallengeId içerecektir.

Çalışma Alanları (Tenants)

Her MailLand hesabı en az bir çalışma alanına (tenant olarak da bilinir) sahiptir. Çalışma alanları; etki alanlarınızı, kimlik bilgilerinizi, şablonlarınızı ve gönderim verilerinizi birbirinden yalıtır.

Birden Fazla Çalışma Alanı Ne Zaman Kullanılır

  • Ayrı ortamlar: production ile staging karşılaştırması
  • Ayrı ürünler: e-posta gönderen birden fazla uygulama çalıştırıyorsanız
  • Ayrı müşteriler: birden fazla müşteri için e-postayı yöneten bir ajansanız

Çalışma Alanı Değiştirme

Çalışma alanları arasında geçiş yapmak için erişim jetonunuzu kullanın. tenantId, çalışma alanının genel dize kimliğidir, kimlikleri GET /v1/account/tenants üzerinden alın:

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

Bu işlem, seçilen çalışma alanı kapsamında yeni bir erişim jetonu döndürür.

İki Faktörlü Kimlik Doğrulama

MailLand, TOTP tabanlı iki faktörlü kimlik doğrulamayı destekler (Google Authenticator, Authy, 1Password vb. ile uyumludur).

2FA'yı Etkinleştirme

  1. TOTP gizli anahtarı ve QR kod URI'si almak için POST /v1/auth/2fa/setup çağrısını yapın
  2. QR kodu kimlik doğrulayıcı uygulamanızla tarayın
  3. POST /v1/auth/2fa/enable aracılığıyla geçerli bir kod göndererek kurulumu onaylayın

Etkinleştirildikten sonra her girişte kimlik doğrulayıcı uygulamanızdan 6 haneli bir kod gerekecektir.

Kurtarma kodlarınızı güvenli bir yerde saklayın. Kimlik doğrulayıcı uygulamanıza erişimi kaybederseniz, kurtarma kodları yeniden erişim sağlamanın tek yoludur.

API Kimlik Doğrulaması

MailLand iki kimlik doğrulama yöntemi kullanır:

Bearer Jetonları (Gösterge Paneli ve Hesap Yönetimi)

Hesap işlemleri için (giriş, çalışma alanı yönetimi, ayarlar) Authorization başlığında JWT bearer jetonlarını kullanın:

Authorization: Bearer eyJhbGciOiJIUzI1NiIs...

Jetonlar, expiresAt içinde belirtilen sürenin ardından geçerliliğini yitirir. Süresi dolmadan önce yeni bir jeton almak için POST /v1/auth/refresh-token kullanın.

API Anahtarları (E-posta İşlemleri)

E-posta gönderimi, etki alanı yönetimi ve tüm işlemsel API çağrıları için X-API-Key başlığında API anahtarlarını kullanın:

X-API-Key: ml_pet_Ab3Kx9mN2pQ7rT4wL8yD...

API anahtarları bir çalışma alanıyla sınırlıdır ve bir son kullanma tarihi belirlemediğiniz sürece geçerliliğini yitirmez. Kimlik bilgisi oluşturma ve yönetimi hakkında ayrıntılar için API Keys sayfasına bakın.

Sonraki Adımlar

Hızlı Başlangıç

Mail.Land ile 5 dakikadan kısa sürede ilk e-postanızı gönderin

API Anahtarları

Ayrıntılı erişim kontrolü ile API kimlik bilgileri oluşturun, yapılandırın ve yönetin

Bu sayfada

Hesap OluşturmaKayıt OlmaE-postanızı DoğrulamaGiriş YapmaÇalışma Alanları (Tenants)Birden Fazla Çalışma Alanı Ne Zaman KullanılırÇalışma Alanı Değiştirmeİki Faktörlü Kimlik Doğrulama2FA'yı EtkinleştirmeAPI Kimlik DoğrulamasıBearer Jetonları (Gösterge Paneli ve Hesap Yönetimi)API Anahtarları (E-posta İşlemleri)Sonraki Adımlar