# Pyzit.com - Disposable Email Detector & Network Tools

> Instantly detect disposable email addresses, prevent fake signups, and verify network health.

Pyzit.com provides a suite of tools for developers and businesses to maintain data integrity and security. Our core service is a high-performance disposable email detection API, complemented by essential network diagnostic tools.

See [llms-full.txt](https://temp-mail-detector.pyzit.com/llms-full.txt) for more comprehensive documentation.

## Core Features

- **Disposable Email Detector**: Identify temporary or throwaway email addresses in real-time. [Link](https://temp-mail-detector.pyzit.com/)
- **DNS Health Checker**: Comprehensive analysis of domain DNS records and configuration. [Link](https://temp-mail-detector.pyzit.com/tools/dns-health-checker)
- **WHOIS Lookup**: Retrieve domain registration and ownership details. [Link](https://temp-mail-detector.pyzit.com/tools/whois-lookup)
- **SSL Checker**: Verify SSL certificate validity and status. [Link](https://temp-mail-detector.pyzit.com/tools/ssl-checker)
- **DMARC/SPF Generators**: Create records to protect against email spoofing. [Link](https://temp-mail-detector.pyzit.com/tools/dmarc-generator)

## API Reference

### Authentication
All API requests require a Bearer Token in the `Authorization` header.
```http
Authorization: Bearer YOUR_API_TOKEN
```

### Endpoints

- **Simple Email Check**: Fastest way to check if an email is disposable.
  - `POST https://api-tempmail.pyzit.com/v1/validate/check/`
  - Body: `{"email": "string"}`
  - Response (200): `{"email": "hi@pyzit.com", "is_disposable": false, "status": "clean"}`

- **Detailed Email Check (Pro)**: Deep intelligence including domain reputation and DNS health.
  - `POST https://api-tempmail.pyzit.com/v1/validate/detailed/`
  - Required Scope: `detailed:tempemail_check`
  - Response (200): Includes `reputation_score`, `risk_level`, `recommendation`, and detailed `signals`.

- **Bulk Email Check (Business)**: Process up to 1,000 emails in a single request.
  - `POST https://api-tempmail.pyzit.com/v1/validate/bulk/`
  - Required Scope: `bulk:tempemail_check`
  - Body: `{"emails": ["email1@domain.com", "email2@domain.com"]}`
  - Response (200): `{"results": {"email1@domain.com": false, "email2@domain.com": true}, "processed": 2}`

## Official SDKs

### JavaScript SDK (@pyzit/tempmail)
Universal support for Node.js, Bun, Cloudflare Workers, Next.js, and React.
```javascript
import { TempMailClient } from "@pyzit/tempmail";
const client = new TempMailClient("YOUR_TOKEN");
const result = await client.check("test@example.com");
```

### Python SDK (tempmail-pyzit)
Sync and Async support for Django, FastAPI, Flask, and more.
```python
from tempmail_pyzit import TempMailClient
client = TempMailClient("YOUR_TOKEN")
result = client.check("test@example.com")
```

## Pro-Tip: Fail-Open Strategy
Never let a third-party API break your signup flow. Always implement a fail-open strategy:
```javascript
try {
  const result = await client.check(email, { timeout: 1500 });
  return result.is_clean;
} catch (error) {
  return true; // Fail open if API is unreachable
}
```

## Resources
- **API Documentation**: [https://temp-mail-detector.pyzit.com/docs/api](https://temp-mail-detector.pyzit.com/docs/api)
- **API Playground**: [https://temp-mail-detector.pyzit.com/playground](https://temp-mail-detector.pyzit.com/playground)
- **Integration Guides**: [https://temp-mail-detector.pyzit.com/docs/guides/fail-open](https://temp-mail-detector.pyzit.com/docs/guides/fail-open)