Zyla API Hub पर EmailLabs सत्यापन API: curl और JSON के साथ पहला अनुरोध

आपकी टीम को उपयोगकर्ता ईमेल को सत्यापित करने की आवश्यकता है इससे पहले कि OTP, चालान, या ऑनबोर्डिंग लिंक भेजे जाएं—और आपको इसे इस सप्ताह काम करने की आवश्यकता है। इस गाइड के अंत तक, आप Zyla API Hub पर EmailLabs सत्यापन API को curl के साथ एक लाइव अनुरोध करेंगे, JSON को पार्स करेंगे, और इसे अपने साइनअप, CRM, या मैसेजिंग वर्कफ़्लो में प्लग करेंगे।

EmailLabs सत्यापन API क्या लौटाता है

EmailLabs सत्यापन API बिना SMTP “पिंग” जांच के एकल ईमेल पते को मान्य करता है। यह विश्लेषण करता है:

Illustration: EmailLabs Verification API on Zyla API Hub: First Request with curl and JSON

RFC 5322 के खिलाफ वाक्य रचना और लंबाई नियम
DNS के माध्यम से डोमेन समाधान और MX रिकॉर्ड
निष्क्रिय प्रदाता पहचान
फ्री-वेबमेल और भूमिका-खाता ध्वज
टाइपो सुझाव

प्रतिक्रियाओं में 0–100 विश्वास स्कोर, एक समग्र स्थिति (मान्य, जोखिम भरा, अमान्य), और संरचित कारण शामिल होते हैं जिन्हें आप लॉग या प्रदर्शित कर सकते हैं। सामान्य उपयोग के मामलों में साइनअप फॉर्म मान्यता, थोक CRM स्वच्छता, चेकआउट जोखिम जांच, और आपके पाइपलाइन में प्रवेश करने से पहले अस्थायी ईमेल को दबाना शामिल है।

Zyla API Hub पर शुरू करना

इस API को कॉल करने के लिए, Zyla पर EmailLabs सत्यापन API लिस्टिंग खोलें, सदस्यता लें, और अपनी कुंजी प्राप्त करें। Zyla एक सदस्यता + कोटा मॉडल का उपयोग करता है, प्रति-कॉल नहीं। इस API के लिए, आप 7-दिन की परीक्षण अवधि या 50 अनुरोधों के साथ शुरू कर सकते हैं। कोई मुफ्त योजना नहीं है।

EmailLabs सत्यापन API पर 7-दिन की परीक्षण अवधि शुरू करें

Zyla आपको एक खाता, एक API कुंजी, और हजारों APIs में एक सदस्यता मॉडल देता है। जब आप बाद में अपने एकीकरण का विस्तार करते हैं तो आप विभिन्न श्रेणियों में एक ही कुंजी का पुन: उपयोग कर सकते हैं।

आप जिस एंडपॉइंट को कॉल करेंगे

EmailLabs सत्यापन API एक सत्यापन एंडपॉइंट प्रदान करता है। यह एक सरल GET है जिसमें एक ईमेल क्वेरी पैरामीटर और बियरर प्राधिकरण है। आप प्राधिकरण हेडर का उपयोग करके अपनी API कुंजी पास करते हैं।

एकल ईमेल सत्यापित करें

विधि: GET
URL: https://zylalabs.com/api/13031/emaillabs-verification-api/26168/verify-email
क्वेरी पैरामीटर: ईमेल (आवश्यक)। उदाहरण: [email protected]
प्राधिकरण: प्राधिकरण: बियरर YOUR_API_KEY

cURL

curl -s -X GET "https://zylalabs.com/api/13031/emaillabs-verification-api/26168/verify-email?email=john.doe%40gmail.com" \
-H "Authorization: Bearer YOUR_API_KEY"

JSON

{
"email": "[email protected]",
"normalizedEmail": "[email protected]",
"status": "valid",
"score": 100,
"isValid": true,
"checks": {
"syntax": {
"valid": true,
"localPart": "john.doe",
"domain": "gmail.com"
},
"length": {
"valid": true,
"localPartLength": 8,
"domainLength": 9,
"totalLength": 18
},
"domain": {
"resolvable": true,
"hasMx": true,
"mxRecords": [
"gmail-smtp-in.l.google.com",
"alt1.gmail-smtp-in.l.google.com",
"alt2.gmail-smtp-in.l.google.com",
"alt3.gmail-smtp-in.l.google.com",
"alt4.gmail-smtp-in.l.google.com"
],
"hasAddressRecord": false,
"nullMx": false
},
"disposable": {
"isDisposable": false
},
"free": {
"isFreeProvider": true
},
"role": {
"isRoleAccount": false
},
"typo": {
"hasSuggestion": false
}
},
"reasons": [
"Domain has MX records",
"Free webmail provider"
]
}

आप जिन फ़ील्ड का वास्तव में उपयोग करेंगे

status: समग्र वर्गीकरण (जैसे, मान्य)। त्वरित अनुमति/अस्वीकृति के लिए इसका उपयोग करें।
score: 0–100 विश्वास। थ्रेशोल्ड के लिए उपयोगी (जैसे, स्वीकार करें ≥ 80)।
isValid: सामान्य अनुमति/अस्वीकृति लॉजिक के लिए बूलियन शॉर्टकट।
checks.syntax.valid: स्पष्ट रूप से गलत पते को जल्दी अस्वीकृत करें।
checks.domain.hasMx और checks.domain.resolvable: यदि आप डिलीवरबिलिटी पर निर्भर करते हैं तो MX + समाधान योग्य डोमेन की आवश्यकता है।
checks.disposable.isDisposable: अस्थायी इनबॉक्स को दबाएं।
checks.free.isFreeProvider: B2C बनाम B2B साइनअप को विभाजित करें या यदि आवश्यक हो तो अतिरिक्त घर्षण लागू करें।
checks.role.isRoleAccount: समर्थन@ या बिक्री@ जैसे भूमिका खातों को ध्वजित करें।
checks.typo.hasSuggestion: जब सत्य हो तो सुधार UX की पेशकश करें (जैसे, gmial.com → gmail.com)।
reasons: ऑडिट लॉग या विश्लेषण के लिए रखें।

JavaScript में पहला अनुरोध (fetch)

नीचे का उदाहरण cURL उदाहरण में उपयोग किए गए समान एंडपॉइंट को कॉल करता है, कोर फ़ील्ड को पढ़ता है, और लॉगिंग या UI के लिए विस्तृत ध्वजों के बाद एक तेज अनुमति/अस्वीकृति निर्णय लागू करने का एक तरीका दिखाता है।

async function verifyEmail(email) {
const url = new URL("https://zylalabs.com/api/13031/emaillabs-verification-api/26168/verify-email");
url.searchParams.set("email", email);

const res = await fetch(url.toString(), {
method: "GET",
headers: {
"Authorization": "Bearer YOUR_API_KEY"
}
});

if (!res.ok) {
// उत्पादन के लिए, res.status और res.text() या res.json() को उचित रूप से लॉग करें
throw new Error(`Verification request failed with status ${res.status}`);
}

const data = await res.json();

// न्यूनतम अनुमति/अस्वीकृति लॉजिक
const allow = data.isValid === true && data.score >= 80;

// विश्लेषण / UI के लिए ध्वज
const flags = {
syntaxValid: data?.checks?.syntax?.valid === true,
mx: data?.checks?.domain?.hasMx === true,
resolvable: data?.checks?.domain?.resolvable === true,
disposable: data?.checks?.disposable?.isDisposable === true,
freeProvider: data?.checks?.free?.isFreeProvider === true,
roleAccount: data?.checks?.role?.isRoleAccount === true,
hasTypoSuggestion: data?.checks?.typo?.hasSuggestion === true,
};

return {
input: email,
normalized: data.normalizedEmail,
status: data.status,
score: data.score,
allow,
flags,
reasons: data.reasons || []
};
}

// उदाहरण उपयोग
verifyEmail("[email protected]")
.then(result => {
console.log("Verification result:", result);
})
.catch(err => {
console.error(err);
});

तेजी से शिपिंग के लिए एकीकरण पैटर्न

साइनअप फॉर्म: बुनियादी क्लाइंट-साइड regex जांच के बाद API को सर्वर-साइड पर कॉल करें। यदि आपको तात्कालिक फीडबैक की आवश्यकता है, तो धुंधलाने पर कॉल करें और स्थिति/स्कोर द्वारा सबमिशन को गेट करें।
लेनदेन भेजने का गेट: पासवर्ड रीसेट या रसीद भेजने से पहले, सत्यापित करें और अमान्य या अस्थायी पते पर भेजने को शॉर्ट-सर्किट करें।
CRM स्वच्छता: अपने मौजूदा संपर्कों को एक सरल कार्यकर्ता के माध्यम से बैच करें जो स्थिति प्राप्त करता है और रिकॉर्ड को स्कोर, फ्री/डिस्पोजेबल ध्वज, और MX उपस्थिति के साथ एनोटेट करता है।
लीड राउटिंग: MX-पॉजिटिव, गैर-डिस्पोजेबल व्यावसायिक डोमेन को प्राथमिकता दें। वर्कफ़्लो को शाखाबद्ध करने के लिए freeProvider और भूमिका ध्वज का उपयोग करें।
चेकआउट जोखिम जांच: चेकआउट पर अस्थायी ईमेल को अस्वीकृत करें या स्कोर थ्रेशोल्ड के आधार पर अतिरिक्त सत्यापन की आवश्यकता करें।

संचालन नोट्स

प्रमाणीकरण: हमेशा प्राधिकरण भेजें: बियरर YOUR_API_KEY।
कैशिंग: एक ही ईमेल के लिए, आप अपने जोखिम सहिष्णुता के आधार पर अपने पक्ष पर परिणामों को कैश कर सकते हैं। डोमेन-स्तरीय DNS जांच स्थिर हैं; अस्थायी सूचियाँ विकसित हो सकती हैं। प्रमुख घटनाओं (पहली भेजें, भूमिका परिवर्तन, या ठंडा होने के बाद) पर फिर से सत्यापित करें।
UX प्रवाह: यदि hasTypoSuggestion सत्य है, तो उपयोगकर्ता को डोमेन को सही करने के लिए मार्गदर्शित करें। यदि freeProvider सत्य है, तो आप अभी भी स्वीकार कर सकते हैं लेकिन लीड स्कोरिंग को समायोजित करें।
थ्रेशोल्ड: एक सरल डिफ़ॉल्ट है जब isValid सत्य है और स्कोर ≥ 80 है, 60–79 की समीक्षा करें, और 60 से नीचे ब्लॉक करें। इसे अपने बाउंस/जोखिम प्रोफ़ाइल के अनुसार ट्यून करें।
ऑडिटिंग: प्रत्येक निर्णय के लिए स्थिति, स्कोर, और कारणों को बनाए रखें ताकि समर्थन वृद्धि तेजी से हो सके।

AI एजेंटों द्वारा MCP के माध्यम से API को कॉल करना

यदि आप Claude Code, Cursor, Windsurf, या किसी भी MCP-संगत क्लाइंट का उपयोग करते हैं, तो आप Zyla के MCP सर्वर के माध्यम से उसी Zyla-होस्टेड एंडपॉइंट को कॉल कर सकते हैं। अपने क्लाइंट को अपनी Zyla API कुंजी के साथ कॉन्फ़िगर करें और इसे MCP सर्वर URL पर इंगित करें। इससे एक AI एजेंट को कोडिंग या डेटा-सफाई सत्र के हिस्से के रूप में ईमेल सत्यापित करने की अनुमति मिलती है।

MCP

क्योंकि EmailLabs सत्यापन API एक आवश्यक ईमेल पैरामीटर के साथ एकल GET एंडपॉइंट का उपयोग करता है, यह प्रॉम्प्ट-चालित उपकरणों या विचारों की श्रृंखला में अच्छी तरह से फिट बैठता है जहां एजेंट एक पता प्रस्तावित करता है और फिर अगले कदम उठाने से पहले सत्यापन कॉल करता है।

परीक्षण चेकलिस्ट

हैप्पी पथ: MX के साथ मान्य पता (जैसे, सामान्य वेबमेल डोमेन)। स्थिति की पुष्टि करें कि यह मान्य है और स्कोर उच्च है।
वाक्य रचना त्रुटियाँ: @ या अवैध वर्ण गायब हैं। अपेक्षा करें कि checks.syntax.valid गलत हो और isValid गलत हो।
गैर-समाधान योग्य डोमेन: एक गैर-मौजूद TLD या डोमेन का उपयोग करें। domain.resolvable: false और domain.hasMx: false की तलाश करें।
अस्थायी पहचान: एक ज्ञात अस्थायी डोमेन का प्रयास करें ताकि आप disposable.isDisposable: true देख सकें और अपनी लॉजिक को तदनुसार समायोजित कर सकें।
भूमिका खाते: वास्तविक डोमेन पर support@ या admin@ का परीक्षण करें ताकि आप role.isRoleAccount: true देख सकें।

सुरक्षा और तैनाती टिप्स

YOUR_API_KEY को उत्पादन में सर्वर-साइड पर रखें। यदि आपको क्लाइंट-साइड जांच की आवश्यकता है, तो अपने सर्वर के माध्यम से प्रॉक्सी करें और अपने अंत पर प्रति-IP या प्रति-सेशन सीमाएँ लागू करें।
निदान के लिए अनुरोध ईमेल और प्रतिक्रिया स्थिति/स्कोर लॉग करें; संवेदनशील उपयोगकर्ता संदर्भ लॉग करने से बचें।
सुचारू फॉलबैक लागू करें: यदि सत्यापन सेवा अस्थायी रूप से अनुपलब्ध है, तो तय करें कि क्या सावधानी से अनुमति दें या सत्यापन को कतार में डालें और अगले कदम को गेट करें (जैसे, पहली भेजें)।

समस्या निवारण

401 या 403: पुष्टि करें कि प्राधिकरण हेडर मौजूद है और कुंजी आपकी सदस्यता के लिए मान्य है।
अप्रत्याशित खाली फ़ील्ड: केवल उदाहरण प्रतिक्रिया में दस्तावेज़ीकृत फ़ील्ड पर भरोसा करें। यदि भविष्य के विकास में कोई फ़ील्ड अनुपस्थित है, तो null/undefined को रक्षात्मक रूप से संभालें।
विकास में धीमी प्रतिक्रियाएँ: DNS जांच नेटवर्क की स्थितियों के अनुसार भिन्न हो सकती हैं। डोमेन-स्तरीय परिणामों को कैश करने और स्थिर नेटवर्क से परीक्षण करने पर विचार करें।

FAQ

क्या API SMTP “पिंग” जांच करता है?
नहीं। यह गैर-SMTP जांच का उपयोग करता है: वाक्य रचना, लंबाई, DNS डोमेन और MX रिकॉर्ड, अस्थायी पहचान, फ्री-वेबमेल और भूमिका-खाता ध्वज, और टाइपो सुझाव।

साइनअप को गेट करने का सबसे तेज़ तरीका क्या है?
फॉर्म सबमिशन पर सर्वर-साइड पर सत्यापन एंडपॉइंट को कॉल करें। अनुमति दें यदि isValid सत्य है और स्कोर आपके थ्रेशोल्ड को पूरा करता है; अन्यथा, एक सुधार संकेत दिखाएँ या एक द्वितीयक ईमेल का अनुरोध करें।

मुझे अस्थायी प्रदाताओं को कैसे संभालना चाहिए?
checks.disposable.isDisposable का उपयोग करें। कई टीमें साइनअप पर अस्थायी ईमेल को सीधे ब्लॉक करती हैं और उन्हें केवल कम-विश्वास वाले अतिथि प्रवाह के लिए अनुमति देती हैं।

क्या मैं B2B बनाम B2C को विभाजित कर सकता हूँ?
हाँ। checks.free.isFreeProvider उपभोक्ता वेबमेल को कस्टम डोमेन से अलग करने में मदद करता है। राउटिंग के लिए भूमिका-खाता ध्वज के साथ संयोजन करें।

एक्सेस विकल्प क्या हैं?
Zyla एक सदस्यता + कोटा मॉडल का उपयोग करता है। इस API के लिए, आप 7-दिन की परीक्षण अवधि या 50 अनुरोधों के साथ शुरू कर सकते हैं। कोई मुफ्त योजना नहीं है। वर्तमान विकल्पों के लिए लिस्टिंग देखें।

क्या आप अपने पहले पते को सत्यापित करने और इसे अपने साइनअप या भेजने की पाइपलाइन में वायर करने के लिए तैयार हैं? लिस्टिंग खोलें और अभी अपनी परीक्षण अवधि शुरू करें: EmailLabs सत्यापन API पर 7-दिन की परीक्षण अवधि शुरू करें