Facteur et Mailisk
Mailisk reçoit des e-mails de test dans des namespaces. Il documente aussi un test SMS. Voici ce qu'il publie, puis ce que fait Facteur.
Ce que Mailisk publie
Chaque ligne est une information que Mailisk 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
Mailisk appelle « namespaces » ses boîtes de réception. Un e-mail envoyé à n'importe quoi@{namespace}.mailisk.net arrive dans la boîte du namespace.
-
02
Chaque namespace admet un nombre illimité d'adresses e-mail.
-
03
La réponse de recherche d'une boîte liste les pièces jointes avec leur identifiant, leur nom, leur type et leur taille.
-
04
La documentation décrit une section de test SMS, avec des points d'accès pour lister les numéros, chercher des messages et simuler un SMS.
-
05
L'offre gratuite affiche 500 e-mails reçus, 1 namespace et 1 jour de conservation des e-mails.
-
06
Les tarifs de volume supplémentaire partent de 0,25 $ par tranche de 1 000 e-mails reçus par mois, et de 0,05 $ par SMS par mois.
-
07
La FAQ indique que les offres payantes tolèrent temporairement un dépassement sans limite stricte, et que Mailisk contacte le client si le dépassement se répète.
-
08
Le client Node de Mailisk s'installe avec npm install --save-dev mailisk et se construit avec new MailiskClient({ apiKey }). Sa méthode searchInbox(namespace, { to_addr_prefix, subject_includes, ... }) attend par défaut qu'au moins un e-mail arrive, cinq minutes au plus.
Le même test, chez l'un puis chez l'autre
Les deux API attendent le message côté serveur, donc la forme du test ne change pas. Ce qui change : l'adresse vise le domaine de l'inbox Facteur, et le code arrive déjà extrait du message.
const { MailiskClient } = require('mailisk');
const mailisk = new MailiskClient({ apiKey: process.env.MAILISK_API_KEY });
// searchInbox attend par défaut qu'au moins un e-mail arrive.
const { data: emails } = await mailisk.searchInbox(namespace, {
to_addr_prefix: address,
});
// Le code reste à chercher dans le corps de emails[0].// 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
Chaque inbox a son domaine. Toute adresse qui s'y termine est acceptée dès le premier message : il n'y a rien d'autre à préparer.
-
Étape 02
Pointer vos envois vers l'inbox
Dans vos scénarios de test, l'adresse du destinataire vise maintenant le domaine de votre inbox Facteur au lieu de celui du namespace.
-
Étape 03
Remplacer searchInbox par la recherche de Facteur
Un seul appel attend le message et le rend avec son code dans le champ otp. L'expression régulière qui cherchait le code disparaît.
-
É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 Mailisk 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 | Mailisk |
|---|---|---|
| Attendre un message | La recherche attend jusqu'au délai demandé, cinq minutes au plus, et répond dès que le message arrive. | searchInbox attend par défaut, cinq minutes au plus. source |
| Adresses | Toute adresse du domaine de l'inbox arrive dans l'inbox, sans rien créer. | Toute adresse du domaine du namespace arrive dans le namespace. source |
| Au-delà du volume | Sur les offres payantes, des packs prépayés ou un dépassement à l'usage, sous un plafond de dépense que vous réglez. | Dépassement toléré sans limite stricte, puis prise de contact s'il se répète. 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. | Une section de test SMS est documentée. 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 Mailisk ?
Mailisk décrit dans sa documentation une section de test SMS avec des points d'accès pour chercher des messages. Chez Facteur, le raccordement à l'opérateur n'est pas en service. Si vos tests ont besoin de SMS dès maintenant, vérifiez ce point avant de choisir.
Combien de travail représente la migration depuis Mailisk ?
Quelques minutes par fichier de test : l'appel à searchInbox devient la recherche de Facteur, et l'extraction du code devient la lecture du champ otp. Rien n'est à exporter, les messages de test se régénèrent au passage suivant de votre intégration continue.
Que deviennent les messages déjà reçus chez Mailisk ?
Ils restent chez Mailisk. Ce sont des messages de test : ils se régénèrent au prochain passage de votre suite, et c'est ce qui rend la migration légère.
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 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.
Facteur et Mailosaur
Ce que Mailosaur publie sur ses offres, sa limite quotidienne, ses SMS 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.