Configuration du compte

Créer un compteCopier le lien de la section

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"
}

Espaces de travail (Tenants)Copier le lien de la section

Chaque compte MailLand dispose d'au moins un espace de travail (également appelé tenant). Les espaces de travail isolent vos domaines, vos identifiants, vos modèles et vos données d'envoi.

Quand utiliser plusieurs espaces de travailCopier le lien de la section

• Environnements séparés : production vs staging
• Produits séparés : si vous gérez plusieurs applications qui envoient des e-mails
• Clients séparés : si vous êtes une agence gérant les e-mails de plusieurs clients

Changer d'espace de travailCopier le lien de la section

Utilisez votre jeton d'accès pour basculer entre les espaces de travail. tenantId est l'identifiant public de type chaîne de l'espace de travail : récupérez les identifiants via 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"
  }'

Cette opération retourne un nouveau jeton d'accès limité à l'espace de travail sélectionné.

Authentification à deux facteursCopier le lien de la section

MailLand prend en charge l'authentification à deux facteurs basée sur TOTP (compatible avec Google Authenticator, Authy, 1Password, etc.).

Activer le 2FACopier le lien de la section

1. Appelez POST /v1/auth/2fa/setup pour obtenir un secret TOTP et un URI de code QR
2. Scannez le code QR avec votre application d'authentification
3. Confirmez la configuration en soumettant un code valide via POST /v1/auth/2fa/enable

Une fois activé, chaque connexion nécessitera un code à 6 chiffres provenant de votre application d'authentification.

Authentification APICopier le lien de la section

MailLand utilise deux méthodes d'authentification :

Jetons Bearer (Tableau de bord et gestion du compte)Copier le lien de la section

Pour les opérations de compte (connexion, gestion des espaces de travail, paramètres), utilisez des jetons JWT bearer dans l'en-tête Authorization :

Authorization: Bearer eyJhbGciOiJIUzI1NiIs...

Les jetons expirent après la durée indiquée dans expiresAt. Utilisez POST /v1/auth/refresh-token pour obtenir un nouveau jeton avant l'expiration.

Clés API (Opérations e-mail)Copier le lien de la section

Pour l'envoi d'e-mails, la gestion des domaines et tous les appels API opérationnels, utilisez des clés API dans l'en-tête X-API-Key :

X-API-Key: ml_pet_Ab3Kx9mN2pQ7rT4wL8yD...

Les clés API sont liées à un espace de travail et n'expirent pas sauf si vous définissez une date d'expiration. Consultez API Keys pour plus de détails sur la création et la gestion des identifiants.

Étapes suivantesCopier le lien de la section

• API Keys : créez des identifiants pour envoyer des e-mails
• Ajouter un domaine : enregistrez votre domaine d'envoi
• Démarrage rapide : envoyez votre premier e-mail