Facteur et Mailosaur
Mailosaur reçoit des e-mails de test dans des serveurs. Son offre Core affiche le SMS à part. Voici ce qu'il publie, puis ce que fait Facteur.
Ce que Mailosaur publie
Chaque ligne est une information que Mailosaur publie. Elle porte l'adresse de la page où nous l'avons lue et la date de lecture. Ce que nous n'avons pas pu vérifier n'y figure pas. Ces pages changent : relisez la source avant de décider.
-
01
La page des tarifs affiche trois offres : Personal à partir de 20 $ par mois et Core à partir de 50 $ par mois, en facturation annuelle, et Enterprise sur devis.
-
02
L'offre Personal annonce 15 000 e-mails reçus par mois, sur la base d'une limite de 500 par jour. L'offre Core annonce 75 000 e-mails reçus par mois, sur la base d'une limite de 2 500 par jour.
-
03
L'offre Personal comprend une boîte de réception, avec un nombre illimité d'adresses e-mail. L'offre Core en comprend plusieurs.
-
04
Sur l'offre Core, la page affiche « SMS et authentification » à partir de 37,50 $ par mois, et les aperçus d'e-mails à partir de 25 $ par mois.
-
05
Le client Node s'installe avec npm install mailosaur et se construit avec new MailosaurClient(clé). Sa méthode messages.get(serverId, { sentTo }) attend le premier e-mail qui correspond, 10 secondes par défaut, un délai que l'option timeout allonge.
-
06
Les codes trouvés dans un message sont dans les tableaux html.codes et text.codes, chacun avec une propriété value.
-
07
La référence de l'API documente GET /api/servers, POST /api/messages/search, GET /api/messages/:id, GET /api/files/attachments/:id, GET /api/files/email/:id (le fichier .eml), GET /api/analysis/deliverability/:id, POST /api/devices/otp et GET /api/usage/limits.
Le même test, chez l'un puis chez l'autre
Les deux clients attendent le message. Ce qui change : l'identifiant de l'inbox remplace le serverId, et le code se lit dans le champ otp au lieu de html.codes.
// Le client Mailosaur, et le code cherché dans le corps.
const MailosaurClient = require('mailosaur');
const mailosaur = new MailosaurClient(process.env.MAILOSAUR_API_KEY);
// Attend le premier message qui correspond, 10 secondes par défaut.
const message = await mailosaur.messages.get(serverId, {
sentTo: address,
});
const code = message.html.codes[0].value;// Aucun paquet Facteur à installer : un appel HTTP qui attend.
const search = new URLSearchParams({
inbox: 'j3k9x2mq',
sentTo: address,
wait: '30000',
});
const response = await fetch('https://api.facteur.eu/v1/messages?' + search, {
headers: { authorization: 'Bearer ' + process.env.FACTEUR_API_KEY },
});
const { messages } = await response.json();
// Le code est déjà extrait, dans un champ à part.
const code = messages[0].otp;Quatre étapes, les deux services côte à côte
-
Étape 01
Créer un compte et une inbox
L'identifiant de l'inbox, huit caractères, joue le rôle du serverId. Toute adresse du domaine de l'inbox arrive dedans.
-
Étape 02
Pointer vos envois vers l'inbox
Vos scénarios écrivent à une adresse du domaine de l'inbox Facteur, avec une étiquette par test après le « + ».
-
Étape 03
Remplacer messages.get
La recherche de Facteur prend inbox, sentTo et wait, et attend le message. Le code se lit dans otp au lieu de html.codes[0].value.
-
Étape 04
Lancer la suite, puis seulement résilier
Gardez les deux comptes le temps que la suite soit verte : il n'y a ni données à exporter, ni DNS à basculer.
Ce qui change, ligne par ligne
Chaque case sur Mailosaur renvoie à la phrase des sources dont elle vient. Une ligne qu'aucune source ne permet d'écrire n'est pas dans le tableau.
| Sujet | Facteur | Mailosaur |
|---|---|---|
| Attendre un message | La recherche attend jusqu'au délai que vous fixez, cinq minutes au plus. | messages.get attend 10 secondes par défaut, plus avec l'option timeout. source |
| Lire le code | otp porte le code le plus probable, codes tous ceux trouvés. | html.codes et text.codes, chacun avec sa propriété value. source |
| Volume | Le volume inclus se compte sur la période de facturation ; seul le dépassement est borné par jour. | Les offres Personal et Core annoncent leur volume sur la base d'une limite par jour. source |
| SMS | Les inboxes SMS existent, mais le raccordement à l'opérateur n'est pas en service : aucun SMS réel n'arrive aujourd'hui. | « SMS et authentification » affiché à part sur l'offre Core. source |
| Source .eml, délivrabilité, TOTP | Aucune de ces trois routes dans l'API publique. | Une route pour chacune. source |
Ce que fait Facteur
Ces lignes décrivent Facteur, telles que ses pages produit et son centre d'aide les donnent.
Une adresse par test
Tout ce qui précède l'arobase est libre. Deux tests qui écrivent à inscription+run-42 et inscription+run-43 reçoivent chacun leur message, dans la même inbox.
Attendre le message en une requête
La recherche accepte un délai d'attente de cinq minutes au plus. Si rien n'arrive, elle répond une liste vide, pas une erreur.
Le code déjà extrait
Le champ otp porte le code à usage unique le plus probable. Quand rien ne l'annonce, Facteur le laisse vide plutôt que de deviner.
Lire ne coûte rien
Seul un message reçu et gardé compte dans votre offre. Un test qui reçoit 3 e-mails et les relit 40 fois en consomme 3.
Supprimé à l'échéance
Chaque message est supprimé à l'échéance de votre offre, avec son fichier brut et ses pièces jointes.
Hébergé chez OVHcloud
L'application et sa base de données sont hébergées chez OVHcloud, et la facturation est en euros. Le centre de données est en France.
Les SMS ne sont pas encore reçus
Le raccordement à l'opérateur qui livre les SMS n'est pas en service. Un numéro attribué ne reçoit aucun SMS réel aujourd'hui.
Questions fréquentes
Quand regarder du côté de Mailosaur ?
Mailosaur publie des routes pour la source .eml d'un message, l'analyse de délivrabilité et les codes TOTP, et des aperçus d'e-mails sur son offre Core. Facteur n'a aucune de ces fonctions. Si votre suite en dépend, regardez du côté de Mailosaur.
Combien de travail représente la migration depuis Mailosaur ?
Le client et l'appel qui attend le message changent, l'assertion sur le code raccourcit. La page Migrer depuis Mailosaur donne la correspondance de chaque appel de l'API.
Que deviennent les messages déjà reçus chez Mailosaur ?
Ils restent chez Mailosaur. Ce sont des messages de test : ils se régénèrent au prochain passage de votre suite.
Où lire les prix de Facteur ?
Sur la page Tarifs, qui lit la grille de Facteur. Aucun prix de Facteur n'est écrit ici.
Les autres outils
La même démarche pour chaque outil : ce qu'il publie, sourcé et daté, puis ce que fait Facteur.
Facteur et Mailisk
Ce que Mailisk publie sur ses namespaces, ses SMS et son offre gratuite, et ce que fait Facteur.
Facteur et Mailtrap
Ce que Mailtrap publie sur son bac à sable d'e-mails, ses aperçus HTML et ses offres, et ce que fait Facteur.
Facteur et MailSlurp
Ce que MailSlurp publie sur ses offres, ses boîtes et ses numéros de téléphone, et ce que fait Facteur.
Facteur et Mailpit
Ce que Mailpit publie sur son logiciel libre, son SMTP et son API, et ce que fait Facteur.
Migrer depuis Mailosaur
La correspondance des appels de l'API, un par un, et ceux qui n'ont pas d'équivalent chez Facteur.
Essayez Facteur sans compte
L'essai reçoit un e-mail de test, sans inscription. Les prix sont sur la page Tarifs.