⚡ fadsync-mailcheck

The Official Python SDK, FastAPI Guard, and Django Validator for FadSync MailCheck.
Block 40M+ disposable burner email domains, autocorrect typos, verify DNS MX servers, and protect authentication pipelines with sub-50ms latency.

🚀 Features

• 🚫 40M+ Disposable Email Detection: Real-time identification of burner domains (10minutemail, GuerrillaMail, Mailinator, etc.).
• ⚡ Sync & Async (httpx): Native asynchronous and synchronous clients for high-throughput backends.
• 🛡️ FastAPI & Django Integrations: 1-line route dependencies (FastAPIEmailGuard) and Django form/model validators.
• 💡 Smart Typo Autocorrect: Catches and suggests fixes for common domain mistakes (user@gamil.com ➔ user@gmail.com).
• ⚡ Thread-Safe In-Memory Cache: Built-in TTL caching with LRU eviction to minimize upstream API calls.
• 🔄 Fail-Safe Resilience (fail_silent=True): Network timeouts and blips never break user signups.
• 🔑 Direct Authentication: Seamless connection with standard FadSync API keys (Authorization: Bearer <API_KEY>).
• 📘 Fully Typed (PEP 561): First-class Pydantic models with complete type hints for PyCharm and VS Code.

📦 Installation

# Core SDK (Sync + Async)
pip install fadsync-mailcheck

# With FastAPI integration
pip install "fadsync-mailcheck[fastapi]"

# With Django integration
pip install "fadsync-mailcheck[django]"

# All integrations
pip install "fadsync-mailcheck[all]"

🔑 Getting Your API Key

1. Sign up for a free account at https://mailcheck.fadsync.com/.
2. Copy your API Key from the Developer Dashboard.
3. Pass it to the client or set the FADSYNC_API_KEY environment variable.

⚡ Quickstart

1. Synchronous Python Usage

from fadsync_mailcheck import FadSyncMailCheck

client = FadSyncMailCheck(api_key="YOUR_FADSYNC_API_KEY")

result = client.verify("tester@10minutemail.com")

if result.is_blocked:
    print(f"❌ Blocked: {result.user_friendly_message}")
    # Output: "Temporary and disposable email addresses are not permitted. Please use a permanent email."
else:
    print(f"✅ Safe to register! Risk score: {result.risk_score}/100")

2. Asynchronous Python Usage (asyncio)

import asyncio
from fadsync_mailcheck import AsyncFadSyncMailCheck

async def main():
    async with AsyncFadSyncMailCheck(api_key="YOUR_FADSYNC_API_KEY") as client:
        result = await client.verify("alex.hunter@gmail.com")
        print(f"Domain: {result.domain}, Has MX: {result.has_valid_mx}")

asyncio.run(main())

3. FastAPI Route Guard Dependency

from fastapi import FastAPI, Depends, status
from pydantic import BaseModel, EmailStr
from fadsync_mailcheck import FastAPIEmailGuard, ValidationResult

app = FastAPI(title="Secured SaaS API")

# Initialize Guard
email_guard = FastAPIEmailGuard(
    api_key="YOUR_FADSYNC_API_KEY",
    block_disposable=True,  # Blocks 40M+ burner domains
    block_dead_mx=True,     # Rejects dead mail domains
)

class SignupRequest(BaseModel):
    name: str
    email: EmailStr
    password: str

@app.post("/api/signup", status_code=status.HTTP_201_CREATED)
async def signup(
    payload: SignupRequest,
    check: ValidationResult = Depends(lambda req: email_guard(req.email)),
):
    # Email is 100% verified, safe, and MX active!
    return {
        "success": True,
        "message": f"Welcome {payload.name}!",
        "risk_score": check.risk_score,
    }

4. Django Form & Model Field Validator

from django.db import models
from fadsync_mailcheck import FadSyncEmailValidator

class UserProfile(models.Model):
    username = models.CharField(max_length=150, unique=True)
    email = models.EmailField(
        unique=True,
        validators=[FadSyncEmailValidator(block_disposable=True)],
    )

⚙️ Configuration Options

📊 Result Object Attributes

📄 License

MIT © FadSync