API Integration Guide for Developers
API Integration Guide for Developers
Getting Your API Key
Sign up at MailEntriX, navigate to API section, generate a key. Never expose it in client-side code.
Single Email Verification
Send a GET request to the verification endpoint with the email as parameter. Response includes verdict, detailed checks, and risk score.
Implementing in Signup Flow
Add verification as server-side validation. Send email to API before creating the account. Return helpful error messages for invalid addresses.
Rate Limiting and Retries
Implement exponential backoff for 429 responses. Cache results for recently checked addresses. 24-hour cache duration is reasonable.
Webhook Integration
Set up webhook endpoints for batch results. Register your URL in dashboard. Results are posted as they complete.
Error Handling
Handle network timeouts gracefully. Never block registration entirely due to verification service outage.
Security
Validate input before sending to API. Use HTTPS. Rotate API keys periodically. Monitor for unexpected usage spikes.