ईमेल पता सत्यापन API
मेलिंग सूचियाँ प्रोग्रामatically सत्यापित करें — कम bounce, बेहतर deliverability
साइनअप फॉर्म, CRM और landing pages को EmailVerifier से जोड़ें। REST API से ईमेल real-time या bulk jobs में जाँचें — पारदर्शी 1 request = 1 credit billing।
- रीयल-टाइम सत्यापन
- Bulk 50,000 ईमेल तक
- 1 अनुरोध = 1 क्रेडिट
अनुरोध उदाहरण
curl -X POST https://propercheck.pl/api/v1/verify \
-H "Authorization: Bearer ev_live_…" \
-d '{"email":"user@company.com"}'API ज्ञान आधार
विषय चुनें — प्रमाणीकरण और क्रेडिट से bulk, webhooks और error codes तक।
POST /verify — एक पता, sub-second परिणाम, valid/invalid/risky status।
और पढ़ेंAPIBulk ईमेल सत्यापनCSV सूचियाँ mass-verify — job queue, progress polling और CSV export।
और पढ़ेंAPIक्रेडिट और billingबैलेंस, API usage, 1 credit = 1 verification, HTTP 402 handling।
और पढ़ेंAPIAPI keys और authBearer ev_live_, token panel, secure key storage best practices।
और पढ़ेंAPIWebhooks और integrationsverification.completed, HMAC signature, CRM और marketing automation।
और पढ़ेंAPIOpenAPI संदर्भपूर्ण YAML spec, Redoc UI और HTTP error catalogue।
और पढ़ेंईमेल सत्यापन API क्या है?
अभियान भेजने से पहले पते validate करने का REST interface।
ईमेल verification API जाँचता है कि पता मौजूद है, domain mail स्वीकार करता है, और inbox disposable या catch-all तो नहीं। bounce rate कम होता है, sender reputation सुरक्षित रहती है और inbox placement बेहतर होती है।
API HTTPS पर /api/v1 पर उपलब्ध है। Bearer key (ev_live_…) या dashboard session से authenticate करें। हर सफल POST /verify एक credit लेता है — subscription नहीं, GET पर छिपे शुल्क नहीं।
ईमेल validator API कब उपयोग करें
B2B products और marketing stacks में सामान्य integration scenarios।
साइनअप फॉर्म
पंजीकरण पर real-time email validate — list insert से पहले invalid और disposable reject करें।
CRM और lead capture
landing pages और webhooks से leads साफ करें — केवल deliverable addresses pipeline में।
अभियान से पहले list hygiene
newsletter से पहले Bulk API — कम bounce, ऊँचा open rate, कम ESP cost।
SaaS प्लेटफ़ॉर्म
अपने product में email checks embed करें — credit-based billing customer pricing सरल बनाती है।
API क्रेडिट मॉडल
सरल pricing: एक verification request = एक credit।
- POST /verify ev_live_ keys के साथ हर सफल request (HTTP 200) पर 1 credit, भले ही वही address पहले API से verify हो चुका हो। Sandbox keys (ev_test_) mock देते हैं, credit debit नहीं।
- GET operations — balance, history, bulk job status, CSV export — मुफ़्त।
- अपर्याप्त balance HTTP 402 (insufficient_credits) देता है। Engine errors (503) credit charge नहीं करते।
Authentication और API keys
Authorization header के जरिए secure access।
- Dashboard में sign in करें और API tokens (/account/api) खोलें।
- Panel में production key (ev_live_) या sandbox test key (ev_test_) बनाएँ — full secret केवल एक बार दिखता है।
- Key Authorization: Bearer ev_live_… के रूप में भेजें — URLs या client-side code में कभी नहीं।
Authorization: Bearer ev_live_YOUR_API_KEY
Content-Type: application/jsonत्वरित शुरुआत — ईमेल सत्यापन API
दो calls: balance check और पहला verification।
1. credit balance जाँचें
curl https://propercheck.pl/api/v1/credits \
-H "Authorization: Bearer ev_live_YOUR_KEY"2. एक email address verify करें
curl -X POST https://propercheck.pl/api/v1/verify \
-H "Authorization: Bearer ev_live_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"email":"john@company.com"}'एकल सत्यापन (रीयल-टाइम)
POST /api/v1/verify JSON में email field स्वीकार करता है। Response में status, score 0–100, provider (Google, Microsoft, regional hosts) और enrichment (MX, catch-all)।
POST /api/v1/verify
JSON प्रतिक्रिया संरचना
सफल verification के बाद लौटाए गए fields।
{
"verificationId": "ver_abc123",
"email": "john@company.com",
"status": "valid",
"score": 92,
"provider": "google",
"enrichment": { "mxRecords": ["aspmx.l.google.com"], "catchAll": false },
"creditsRemaining": 149
}ईमेल सत्यापन स्थितियाँ
API, dashboard और CSV exports में classification।
valid
valid — पता मौजूद है और mail ले सकता है; भेजना safe।
invalid
invalid — पता नहीं या domain में mail नहीं; list से हटाएँ।
risky
risky — कम confidence (जैसे disposable, role account); campaigns में सावधानी।
catch_all
catch_all — server domain पर सभी addresses स्वीकार करता है; bounce risk अधिक।
unknown
unknown — inconclusive SMTP response; बाद में re-verification पर विचार करें।
REST एंडपॉइंट संदर्भ
credit cost के साथ पूर्ण API v1 path list।
| Method | Path | Credits | विवरण |
|---|---|---|---|
| POST | /verify | 1 | रीयल-टाइम एकल ईमेल सत्यापन |
| GET | /verify/:id | 0 | verificationId से result fetch |
| GET | /verifications | 0 | Verification history और 30-day stats |
| GET | /credits | 0 | वर्तमान खाता क्रेडिट शेष |
| POST | /bulk | N | Bulk job बनाएँ (N credits) |
| GET | /bulk/:id | 0 | Bulk job status और progress |
| GET | /bulk/:id/export | 0 | CSV के रूप में results download |
| GET/POST/PATCH/DELETE | /api-keys | 0 | API टोकन प्रबंधन (सत्र) |
| GET/POST/DELETE | /webhooks | 0 | वेबहुक कॉन्फ़िगरेशन (सत्र) |
| GET | /usage | 0 | API और credit usage statistics |
बल्क ईमेल सत्यापन API
एक job में हज़ारों addresses — बड़े campaigns से पहले ideal।
- POST /bulk emails array या CSV text — N unique addresses के लिए credits reserved।
- GET /bulk/:id — status poll (queued → processing → completed)।
- GET /bulk/:id/export — email, status, score, provider columns वाला CSV download।
curl -X POST https://propercheck.pl/api/v1/bulk \
-H "Authorization: Bearer ev_live_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"emails":["a@b.co","c@d.co"]}'वेबहुक — verification.completed
Verification complete होने पर POST आपके URL पर। Header X-EV-Signature body का HMAC-SHA256 — process से पहले verify करें।
X-EV-Event: verification.completed
X-EV-Signature: <hmac-sha256 of body>दर सीमाएँ
Default 60 requests per minute per API key। Exceeding HTTP 429 with rate_limit_exceeded। Limits per key — integrations के लिए अलग tokens।
POST /verify पर optional header — same key पर double credit debit बिना safe retries (24h TTL)।
X-Request-Id
हर API response में X-Request-Id — integration debugging support contact में include करें।
HTTP त्रुटि कोड
| HTTP | Code | विवरण |
|---|---|---|
| 401 | unauthorized | request में session या API key missing। |
| 401 | invalid_api_key | Invalid, expired या revoked API key। |
| 400 | invalid_request | Invalid JSON, email field missing या malformed address। |
| 402 | insufficient_credits | Insufficient credits — /account/credits पर top up करें। |
| 429 | rate_limit_exceeded | Rate limit exceeded — default 60 requests/min per API key। |
| 503 | engine_unavailable | Verification engine unavailable — credit charge नहीं। |
एकीकरण उदाहरण
लोकप्रिय languages में same verification flow।
curl -X POST https://propercheck.pl/api/v1/verify \
-H "Authorization: Bearer ev_live_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"email":"john@company.com"}'FAQ — ईमेल सत्यापन API
developers और marketers के common questions।
OpenAPI 3.1 और Redoc
codegen, contract tests और CI pipelines के लिए machine-readable spec।
API से emails verify करना शुरू करें
Signup पर free trial credits। Dashboard में एक minute में API key।
Account panel में key generate करें।