Documentation API MailProtect

Version 1.0 · Base URL : https://api.mailprotect.fr/v1

Authentification

Tous les endpoints API B2B utilisent l'en-tête X-MP-Key avec votre clé publique mp_pk_xxx. Obtenez votre clé sur le Dashboard.

X-MP-Key: mp_pk_votre_cle_publique

Codes d'erreur

Code	Signification
`401`	Clé API absente ou invalide
`403`	Endpoint non inclus dans votre plan
`429`	Quota mensuel dépassé
`502`	Erreur service tiers (Stripe)
`422`	Validation des paramètres échouée

Rate limiting

Plan	Appels/minute	Appels/mois
Free	10	1 000
Starter	60	10 000
Pro	600	100 000
Enterprise	6 000	1 000 000

SDKs & outils

Widget JavaScript intégrable disponible sur widget-demo.html. SDKs Python et PHP en cours de développement.

Endpoints API B2B

POST /auth-mail/verify Vérifie si une adresse email appartient à un humain réel

Disponible sur tous les plans, y compris Free.

Paramètre	Type	Requis	Description
`email`	string	OUI	Adresse email à vérifier

{"verified": true, "confidence": 0.95, "reason": "community_validated"}

GET /marketplace-api/check-domain-reputation Score de confiance d'un domaine

Plans Starter, Pro et Enterprise.

Paramètre	Type	Requis	Description
`domain`	string (query)	OUI	Nom de domaine (ex : evil-bank.ru)

{"domain": "evil-bank.ru", "trust_score": 0.0, "reports_count": 12, "age_days": null, "ssl_valid": false}

GET /marketplace-api/check-iban Valide un IBAN (format + checksum + banque)

Plans Starter, Pro et Enterprise.

Paramètre	Type	Requis	Description
`iban`	string (query)	OUI	IBAN au format ISO 13616 (espaces acceptés)

{"iban": "FR7630006000011234567890189", "valid": true, "format_valid": true, "checksum_valid": true, "bank_info": {"bank": "BNP Paribas", "country": "FR"}}

POST /marketplace-api/scan-text-for-phishing Détecte les patterns phishing dans un texte

Plans Starter, Pro et Enterprise. Texte max 50 000 caractères. Pas de stockage (RGPD).

Paramètre	Type	Requis	Description
`text`	string (body)	OUI	Texte à analyser (mail, description, commentaire…)

{"phishing_detected": true, "score": 0.43, "warnings": [{"severity": "high", "type": "phishing_pattern", "message": "..."}], "warnings_count": 1}

Gestion du compte

GET /marketplace-b2b/plans Liste les 4 plans disponibles

Auth JWT requise. Retourne features, prix et endpoints inclus pour chaque plan.

POST /marketplace-b2b/subscribe Souscrit ou met à niveau un plan

Champ	Type	Requis	Description
`plan`	string	OUI	starter \| pro \| enterprise
`payment_method_id`	string	OUI	ID Stripe du moyen de paiement (pm_xxx)
`org_name`	string	non	Nom de l'organisation (pour la facture)

POST /marketplace-b2b/cancel Annule la subscription à fin de période

L'accès est maintenu jusqu'à la date d'expiration. Plan_expires_at retourné.

GET /marketplace-b2b/usage?days=30 Stats d'usage (1-90 jours)

Retourne total_calls, by_endpoint, by_day, success_rate, quota restant.

GET /marketplace-b2b/invoices Liste les factures Stripe

Retourne amount_due, currency, status, invoice_pdf (lien PDF direct), created.