Référence de l’API

Cette référence liste tous les endpoints qu’une intégration peut appeler avec une clé API. Elle est générée à partir du document OpenAPI de l’API, limité aux endpoints qui acceptent une clé API ; les endpoints propres au tableau de bord client (connexion, compte, équipe, facturation) ne font pas partie de l’API publique et n’y figurent pas. Chaque endpoint est décrit en anglais.

URL de base et authentificationCopier le lien de la section

Toutes les requêtes sont envoyées à https://api.mail.land et portent votre clé dans l’en-tête X-API-Key :

curl https://api.mail.land/v1/transactional/send \
  -H "X-API-Key: ml_pet_..." \
  -H "Content-Type: application/json" \
  -d '{"from":{"email":"[email protected]"},"to":[{"email":"[email protected]"}],"subject":"Hello","htmlContent":"<p>Hello</p>"}'

Les clés d’envoi de production commencent par ml_pet_ (transactionnel) ou ml_pem_ (marketing). Les clés sandbox commencent par ml_set_ ou ml_sem_, les clés de réception par ml_pi_ et les clés de validation par ml_pv_. Voir Clés API.

SectionsCopier le lien de la section

Les erreurs et les limites s’appliquent à tous les endpoints : voir Codes d’erreur et Limites de débit. L’engagement de compatibilité de /v1 figure dans Compatibilité de l’API.