Documentation
Documentation API
Tout ce dont vous avez besoin pour intégrer Mailhook dans votre application.
Guide de démarrage rapide
Soyez opérationnel avec Mailhook en moins de 5 minutes.
1. Obtenez vos identifiants API
Créez un compte gratuit et générez vos identifiants API.
- Créez un compte sur app.mailhook.co
- Allez dans Paramètres → API
- Générez une nouvelle clé API
- Sauvegardez votre Agent ID et votre clé API en sécurité
2. Créez votre première boîte
Utilisez l'API pour créer une adresse email aléatoire.
curl -X POST https://app.mailhook.co/api/v1/email_addresses/random \
-H "X-Agent-ID: your_agent_id" \
-H "X-API-Key: your_api_key" \
-H "Content-Type: application/json" \
-d '{"domain_id": "your_domain_id"}'
3. Recevez des emails
Interrogez les emails entrants ou configurez des webhooks pour des notifications temps réel.
curl https://app.mailhook.co/api/v1/email_addresses/{id}/inbound_emails \
-H "X-Agent-ID: your_agent_id" \
-H "X-API-Key: your_api_key"
Exemple de réponse
{
"data": [
{
"id": "ie_abc123",
"type": "inbound_email",
"attributes": {
"from": "[email protected]",
"subject": "Hello from Mailhook",
"text_body": "Your email content here...",
"received_at": "2025-01-14T12:00:00Z"
}
}
]
}
Prochaines étapes
- Configurez des webhooks pour les notifications email en temps réel
- Ajoutez un domaine personnalisé pour des adresses email brandées
- Explorez la référence API complète pour tous les endpoints disponibles
Configuration des Webhooks
Configurez les webhooks pour recevoir les emails en temps réel avec des payloads signés.
Domaines personnalisés
Ajoutez et vérifiez votre propre domaine pour des adresses email brandées.
Intégration Agents IA
Bonnes pratiques pour intégrer Mailhook avec les agents LLM et l'automatisation.
Tests CI/CD
Utilisez Mailhook dans votre suite de tests pour les flux de vérification email.
Limites & Bonnes pratiques
Comprenez les limites de taux et optimisez votre utilisation de l'API.
Gestion des erreurs
Gérez les erreurs API gracieusement avec les bons codes d'erreur et la logique de retry.