Integration

Implementation Guide

Name: Disposable Email Detector
Author: Pyzit.com

Integrate Pyzit across your entire stack. From instant frontend feedback to robust backend security.

Choose your strategy

Frontend

Improve UX by alerting users immediately as they type in your signup forms.

Backend

The source of truth. Block disposable emails at the database level during registration.

Scripts

Use our Bulk API to clean legacy databases and marketing lists at scale.

Backend Integration (Recommended)#

Always perform validation on your server. This prevents users from bypassing your security by disabling client-side scripts.

Standard Flow

Receive Request → Call Pyzit API → Allow/Deny Signup → Save to DB

Before you begin, ensure you have created an API token with the necessary scopes.

Node.js (Express)

// Install axios: npm install axios const axios = require('axios'); app.post('/register', async (req, res) => { const { email } = req.body; try { const response = await axios.post( 'https://api.temp-mail.pyzit.com/v1/validate/check/', { email }, { headers: { 'Authorization': `Bearer ${process.env.PYZIT_TOKEN}`, 'Content-Type': 'application/json' } } ); if (response.data.is_disposable) { return res.status(400).json({ error: "Temporary emails are not permitted." }); } // Proceed with registration... } catch (error) { // Handle API errors (e.g., allow signup if API is down) console.error('Pyzit API Error:', error.message); return proceedWithRegistration(); } });

Python (Requests)

import requests import os def validate_signup(email): url = "https://api.temp-mail.pyzit.com/v1/validate/check/" headers = { "Authorization": f"Bearer {os.getenv('PYZIT_TOKEN')}", "Content-Type": "application/json" } response = requests.post(url, json={"email": email}, headers=headers) if response.status_code == 200: result = response.json() if result.get("is_disposable"): return False, "Disposable emails blocked" return True, None

Frontend Integration#

Provide instant feedback to your users. We recommend calling your own backend which then proxies the request to Pyzit to keep your API token secure.

Security Warning: Never call the Pyzit API directly from the browser using your primary API token. It will be exposed to users.

React / Vue / Svelte

// Call your own backend proxy const handleEmailBlur = async (email) => { const res = await fetch('/api/proxy/validate-email', { method: 'POST', body: JSON.stringify({ email }) }); const { is_disposable } = await res.json(); if (is_disposable) { setFormError("Please use a work or personal email address."); } };

Integration Best Practices

Fail-Safe Implementation

Always wrap your API calls in try/catch blocks. If the Pyzit API is unreachable or returns an error, your application should "fail open" and allow the user to register to avoid blocking legitimate signups.

Environment Secrets

Store your API tokens in environment variables (e.g., PYZIT_TOKEN). Never hardcode them in your source code or commit them to version control.