Une API d'e-mail qui fonctionne avec le client HTTP que vous avez déjà.
Aucun SDK à installer : curl, fetch ou requests suffit. Un schéma OpenAPI, des erreurs structurées et un mode test rendent le reste prévisible.
- Pas de carte pour tester
- Prix en euros, hors TVA
curl -X POST https://api.outstamp.dev/v1/emails \
-H "Authorization: Bearer $OUTSTAMP_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: welcome-42" \
-d '{
"from": "Acme <[email protected]>",
"to": "[email protected]",
"subject": "Bienvenue chez Acme",
"html": "<p>Votre compte est prêt.</p>"
}'const response = await fetch("https://api.outstamp.dev/v1/emails", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.OUTSTAMP_API_KEY}`,
"Content-Type": "application/json",
"Idempotency-Key": `welcome-${user.id}`
},
body: JSON.stringify({
from: "Acme <[email protected]>",
to: "[email protected]",
subject: "Bienvenue chez Acme",
html: "<p>Votre compte est prêt.</p>"
})
});
const email = await response.json(); // 202, { id, status: queued }import os, requests
response = requests.post(
"https://api.outstamp.dev/v1/emails",
headers={
"Authorization": f"Bearer {os.environ['OUTSTAMP_API_KEY']}",
"Idempotency-Key": f"welcome-{user.id}",
},
json={
"from": "Acme <[email protected]>",
"to": "[email protected]",
"subject": "Bienvenue chez Acme",
"html": "<p>Votre compte est prêt.</p>",
},
)
email = response.json() # 202, { id, status: queued }Conçue pour votre façon de travailler.
Des erreurs exploitables
Chaque erreur a un
type, uncodestable, leparameteren cause, unrequest_id, et indique si elle estretryable.Un schéma OpenAPI
Un schéma canonique unique décrit chaque endpoint, champ et erreur, pour votre générateur de client ou vos tests.
Une doc lisible par votre agent de code
llms.txt et llms-full.txt donnent aux outils de code IA toute la documentation en une seule requête.
Des clés de test aux résultats connus
Les clés
os_test_et les adresses du simulateur permettent à votre suite de tests de vérifier les rebonds et les plaintes, pas seulement le cas nominal.
Quand vous voudrez peut-être autre chose.
Nous préférons que vous choisissiez bien plutôt que de changer deux fois.
- Vous voulez un SDK typé dans votre langage dès aujourd'hui. Outstamp n'en a pas encore, mais le schéma OpenAPI permet d'en générer un.
- Votre stack ne parle que SMTP. Outstamp n'a pas encore de relais SMTP.
De la clé au premier e-mail.
- 1
Copiez une clé de test
Créez-la dans le tableau de bord et gardez-la dans l'environnement de votre serveur.
- 2
Faites une requête
POST /v1/emailsavec from, to, subject et html. Vous recevez202et un identifiant. - 3
Lisez les événements
GET /v1/emails/{id}/events, ou abonnez un endpoint de webhook.
Questions de développeurs.
Quels langages puis-je utiliser ?
Tout langage capable de faire une requête HTTPS. La documentation montre curl, Node.js et Python.
Y a-t-il une limite de débit ?
Oui, par projet, et elle augmente à mesure que votre historique d'envoi se construit. Les limites et leurs codes d'erreur sont dans Limites et erreurs.
Comment savoir ce qui n'a pas marché avec une requête ?
Journalisez le request_id renvoyé avec l'erreur. Il relie la requête à l'e-mail dans votre tableau de bord.
Faites votre première requête en mode test.
Sans carte, sans DNS et sans SDK.
- Pas de carte pour tester
- Prix en euros, hors TVA