Vos envois, scriptables de bout en bout.
L'API REST à nu : pour vos scripts, vos tâches planifiées et l'agent de votre choix. Rien à installer — un appel HTTP suffit.
Lis mailcheer.com/cli/install et connecte Mailcheer pour moi.Détails de connexion
| Surface | API REST — curl, ou n'importe quel langage qui sait faire du HTTP |
|---|---|
| Connexion | Clé d'API en en-tête Bearer, créée dans Réglages → API |
| Périmètre | Un espace Mailcheer par clé, avec les droits que vous cochez |
| Révocation | Un clic dans Réglages → API, effet au prochain appel |
Il n'y a pas de programme à installer : « mailcheer » n'est pas une commande à télécharger, c'est une adresse à appeler. Le fichier OpenAPI permet d'engendrer un client dans votre langage si vous en voulez un.
Connexion en 3 étapes
Créez une clé dans votre espace Mailcheer : Réglages → API → Nouvelle clé.
Rangez-la dans une variable d'environnement — jamais en clair dans un script partagé.
Appelez /api/v1/me pour vérifier : la réponse nomme votre espace et vos domaines vérifiés.
Ce que vous pouvez demander
Six exemples à copier, du premier brouillon à la santé du domaine.
Campagnes
Écris-moi un script qui prépare le brouillon du jeudi et m'envoie son lien.
Ajoute à mon cron un envoi à blanc avant chaque campagne : si elle ne peut pas partir, il s'arrête.
Abonnés
Sors la liste des abonnés inscrits cette semaine, en JSON.
Ajoute ces adresses à ma liste, avec la confirmation par e-mail.
Domaine & délivrabilité
Ajoute un contrôle quotidien de mes rebonds et préviens-moi si ça monte.
Vérifie que cette adresse n'est pas dans ma liste de suppression.
Ce que l'agent peut faire
- Envoyer un e-mail unitaire, avec suivi de son état ensuite.
- Lister, ajouter et désinscrire des abonnés, page par page.
- Lire et compléter la liste de suppression.
- Créer un brouillon de campagne, l'envoyer, lire ses chiffres.
- S'intégrer à vos scripts et vos tâches planifiées, dans n'importe quel langage.
Ce qu'il ne peut pas faire
- Envoyer quoi que ce soit avec une clé à laquelle vous n'avez pas donné le droit d'envoi.
- Écrire depuis une adresse dont le domaine n'est pas vérifié dans votre espace.
- Envoyer une campagne à quelqu'un qui s'est désinscrit, ou écrire à une adresse revenue en erreur.
- Retirer une adresse de la liste de suppression : aucun outil ne le permet.
- Voir un autre espace que celui de la clé utilisée.
Un accès utile, des limites nettes
Une clé, un espace
Chaque clé est liée à un seul espace Mailcheer. Vos autres marques ou clients restent invisibles pour l'agent, sans réglage à faire.
Vous cochez ce que la clé peut faire
Sept droits, choisis à la création : envoyer des e-mails, lire les abonnés, les modifier, lire les campagnes, les envoyer, lire les webhooks, les gérer. Une clé sans le droit d'envoi ne pourra jamais expédier, même si l'agent le demande.
Révocation immédiate
Un clic dans Réglages → API coupe la clé. L'appel suivant est refusé, et les autres clés continuent de fonctionner.
Questions fréquentes
Non, et c'est volontaire : un binaire de plus à installer et à tenir à jour, pour envelopper des appels HTTP que curl fait déjà. La référence donne un exemple curl par point d'entrée.
Comme de n'importe quelle API HTTP. Le fichier OpenAPI décrit chaque champ et chaque erreur : la plupart des langages savent en engendrer un client.
L'en-tête Idempotency-Key, avec une valeur unique par envoi. Rejouer le même appel rend la même réponse, sans second envoi.
600 par clé. Chaque réponse porte les en-têtes qui disent où vous en êtes, et un refus dit en combien de secondes réessayer.
Avec les adresses du simulateur d'Amazon SES, comme success@simulator.amazonses.com : elles acceptent le message, puis le jettent.
Tout tient dans une ligne.
Lis mailcheer.com/cli/install et connecte Mailcheer pour moi.