Ressources Développeurs

Une API simple, puissante et hautement prévisible

Intégrez la puissance de Mail25 dans votre stack en quelques lignes de code. Authentification par Bearer token, charges utiles JSON et webhooks idempotents.

Générer une clé API → Voir le guide de démarrage

Sécurité & Accès

Authentification par Jeton API

Toutes les requêtes vers l’API Mail25 nécessitent une clé API passée dans l’en-tête Authorization. Les clés sont générées depuis votre espace client sans formalité.

Authorization: Bearer YOUR_MAIL25_API_KEY
Content-Type: application/json
Accept: application/json
                

✓ Architecture sans état pour une montée en charge optimale
✓ Clés créées instantanément sans approbation manuelle
✓ Limites adaptées aux quotas de votre abonnement actif

curl -X POST https://app.mail25.cloud/api/v1/emails/send \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "from": "[email protected]", "to": ["[email protected]"], "subject": "Votre code d'\''accès confidentiel", "html": "<h1>Bienvenue</h1><p>Votre session a été initialisée sans KYC.</p>", "reply_to": "[email protected]" }'

<?php use Symfony\Component\HttpClient\HttpClient; $client = HttpClient::create(); $response = $client->request('POST', 'https://app.mail25.cloud/api/v1/emails/send', [ 'headers' => [ 'Authorization' => 'Bearer YOUR_API_KEY', 'Content-Type' => 'application/json', ], 'json' => [ 'from' => '[email protected]', 'to' => ['[email protected]'], 'subject' => 'Votre code d\'accès confidentiel', 'html' => '<h1>Bienvenue</h1><p>Session active sans KYC.</p>', 'reply_to' => '[email protected]', ], ]); $statusCode = $response->getStatusCode(); $data = $response->toArray();

import requests url = "https://app.mail25.cloud/api/v1/emails/send" headers = { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" } payload = { "from": "[email protected]", "to": ["[email protected]"], "subject": "Alerte de sécurité Mail25", "html": "<p>Message envoyé via Python sans KYC.</p>", "reply_to": "[email protected]" } response = requests.post(url, json=payload, headers=headers) print(response.status_code, response.json())

const response = await fetch('https://app.mail25.cloud/api/v1/emails/send', { method: 'POST', headers: { 'Authorization': 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json' }, body: JSON.stringify({ from: '[email protected]', to: ['[email protected]'], subject: 'Confirmation Node.js', html: '<p>Exécution ultra-rapide Mail25.</p>', reply_to: '[email protected]' }) }); const result = await response.json(); console.log(result);

Temps Réel

Réception par Webhook Inbound

Configurez l’URL de votre application dans la console. Dès qu’un email frappe votre nom de domaine, nous vous transmettons un événement POST JSON avec l’ensemble des données parsées.

Structure du Payload Webhook Entrant

{ "event": "email.delivered", "id": "msg_01a1ad43-182b-7126-ba7b-1eeee4d1b884", "from": "[email protected]", "to": ["[email protected]"], "subject": "Demande de partenariat confidentiel", "body_preview": "Bonjour, nous souhaitons déployer Mail25...", "attachments_count": 0, "timestamp": 1730851200, "security": { "spf": "pass", "dkim": "pass" } }