ShazaMail API
Une API REST puissante pour créer et gérer des adresses email temporaires à la volée. Construisez des tests automatisés, protégez la vie privée de vos utilisateurs, ou intégrez ShazaMail dans votre application.
Quick Start
Intégrez ShazaMail en moins de 5 minutes.
Obtenez votre clé API
Créez un compte et générez votre clé API depuis le dashboard.
Créez une boîte mail
Appelez POST /api/v1/inboxes pour créer une adresse temporaire instantanément.
Lisez les messages
Interrogez GET /api/v1/inboxes/{address}/messages pour récupérer les emails reçus.
Configurez un webhook
Recevez les emails en temps réel en enregistrant votre endpoint via POST /api/v1/webhooks.
curl -X POST https://api.shazamail.tech/api/v1/inboxes \
-H "X-Api-Key: sk_live_xxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{"domain": "shazamail.tech"}'Authentification
Toutes les requêtes doivent inclure votre clé API dans le header X-Api-Key.
Production
Préfixe sk_live_ — transactions réelles
Sandbox
Préfixe sk_test_ — tests sans frais
API Reference
Explorez et testez tous les endpoints directement depuis la documentation.
Webhooks
Recevez des notifications en temps réel lorsque de nouveaux emails arrivent.
Événements disponibles
Vérification de signature
import crypto from "crypto";
function verifySignature(payload: string, signature: string, secret: string) {
const expected = crypto
.createHmac("sha256", secret)
.update(payload)
.digest("hex");
return crypto.timingSafeEqual(
Buffer.from(signature),
Buffer.from(`sha256=${expected}`)
);
}SDKs & Libraries
Bibliothèques officielles pour intégrer ShazaMail en quelques lignes.
JavaScript
shazamail-jsv1.2.0
Python
shazamailv1.0.3
PHP
shazamail/phpv0.9.1
Go
shazamail-gov0.5.0
Codes d'erreur
Toutes les erreurs retournent un JSON avec un champ code machine-readable.
| Status | Code | Description |
|---|---|---|
| 400 | bad_request | Paramètres manquants ou invalides |
| 401 | unauthorized | Clé API absente ou invalide |
| 403 | forbidden | Plan insuffisant pour cette ressource |
| 404 | not_found | Ressource introuvable |
| 429 | rate_limit_exceeded | Trop de requêtes — voir Retry-After |
| 500 | server_error | Erreur interne, réessayez plus tard |
Rate Limits
Les limites sont retournées dans les headers X-RateLimit-* de chaque réponse.
| Plan | Rate | Boîtes | Webhooks |
|---|---|---|---|
| Free | 10 req/min | 100/jour | Non |
| Pro | 100 req/min | 10 000/j | Oui |
| Enterprise | Illimité | Illimitées | Oui |
En cas de dépassement, la réponse 429 inclut un header Retry-After indiquant le délai en secondes avant de réessayer.