Facteur pour les développeurs
Facteur reçoit les e-mails que votre application envoie pendant un test, et les garde dans une inbox. La réception des SMS n’est pas encore en service. L’API permet à un script ou à une suite de tests de lister ces inboxes, de lire et de chercher les messages qu’elles contiennent, et de télécharger leurs pièces jointes, sans ouvrir de navigateur.
Obtenir une clé d’API
Section intitulée « Obtenir une clé d’API »Une clé d’API appartient à votre organisation et non à une personne : elle continue de marcher quand celle qui l’a créée s’en va. Il faut être propriétaire ou administrateur de l’organisation pour en créer une.
- Ouvrez Paramètres, puis Clés d’API, dans l’application Facteur, et choisissez Créer une clé.
- Donnez-lui un nom, choisissez ce qu’elle peut faire et les espaces de travail qu’elle atteint, puis une durée de 30, 90, 180 ou 365 jours.
- Copiez la clé dès qu’elle apparaît. Facteur n’en garde qu’une empreinte : la clé s’affiche une seule fois et ne peut pas être affichée de nouveau.
Une clé en lecture seule suffit pour une suite de tests.
Appeler l’API
Section intitulée « Appeler l’API »Chaque requête porte la clé dans l’en-tête Authorization :
curl -H "Authorization: Bearer fk_votre_cle" https://api.facteur.eu/inboxesUne clé peut faire 600 requêtes par minute. Au-delà, l’API répond 429 avec un en-tête Retry-After.
La référence existe aussi en document, public.json, et en collection Postman, public.postman.json.
Ce qui n’est pas encore publié
Section intitulée « Ce qui n’est pas encore publié »Aucun SDK et aucun plugin pour Playwright ou Cypress n’est encore publié. Depuis une suite de tests, on appelle l’API en HTTP.
Facteur ne promet pas encore que l’API reste telle qu’elle est. La référence ci-dessous décrit l’API du jour, et l’adresse d’une route ne porte aucune version.