ZeroBounce API का उपयोग कैसे करें

मान्य ईमेल (v1)

Below you will find the instructions on how to use our API, it's very easy to use and requires SSL. The API requires that you have an active credit balance and will never consume a credit for any unknown result. This endpoint can be called asynchronously and is currently not rate limited.

क्रेडिट का उपयोग किए बिना एपीआई या एपीआई का परीक्षण करने के लिए - कृपया हमारे सैंडबॉक्स प्रलेखन में दिए गए ईमेल का उपयोग करें।

हमारे एपीआई के लिए प्रतिक्रिया समय एक सेकंड और 70 सेकंड के बीच है। चूँकि एपीआई स्वभाव से तेज़ होते हैं, इसलिए हम एक ईमेल पते को मान्य करने में जितना समय खर्च करते हैं, उसे सीमित कर देते हैं। इसलिए अगर हम एक धीमी मेल सर्वर या मेल सर्वर के साथ एक greylisting एल्गोरिथ्म का सामना करते हैं तो आपको एक अज्ञात परिणाम मिलेगा। आप उन शर्तों को फिर से मान्य कर सकते हैं, जो एक फाइल को थोक ईेल सत्यापनकर्ता पर अपलोड करती हैं।

सभी डोमेन के औसत 96-98% 1 से 5 सेकंड में लौट आएंगे, कुछ ऐसे डोमेन हैं जो पोस्टफ़िक्स / डवकोट से दूर चलते हैं जिनके पास वास्तविक समय सत्यापन के लए 20 दूसरा कनेक्शन समय है और बहुत अन्य डोमेन का छोटा अंश प्रतिशत जो SMTP पूछताछ का जवाब देने के लिए बहुत धीमा है। सभी प्रमुख ISP 1 से 3 सेकंड में लौट आएंगे, जो आमतौर पर अधिकांश ईमेल वितरण का बहुमत है।

प्राप्त / v1 / मान्य

API URL: https://bulkapi.zerobounce.net/v1/validate

API URL (GEO परिशिष्ट के साथ): https://bulkapi.zerobounce.net/v1/validatewithip

URL पैरामीटर

  • पैरामीटर
    विवरण
  • ईमेल
    वह ईमेल पता जिसे आप सत्यापित करना चाहते हैं
  • ipaddress
    IP पते से साइन अप किया गया ईमेल (रिक्त हो सकता है, लेकिन आवश्यक पैरामीटर)
  • apikey
    आपकी API कुंजी, आपके खाते में मिली

यदि आप इसे परीक्षण करने के लिए अपने ब्राउज़र से एपीआई को कॉल करना चाहते हैं, तो आपको बस अपनी कुंजी के साथ एपीआई कुंजी को बदलना होगा:

https://api.zerobounce.net/v1/validatewithip?apikey=replacewithyours&email=valid@example.com&ipAddress=156.124.12.145

या यदि आपको GEO परिशिष्ट की आवश्यकता नहीं है तो बस मान्य विधि को कॉल करें।

https://api.zerobounce.net/v1/validate?apikey=replacewithyours&email=valid@example.com

एपीआई "वेलिडेट" विधि का उपयोग करते हुए JSON प्रारूप में इन परिणामों को लौटाएगा।

  • गुण
    विवरण
  • पता
    वह ईमेल पता जिसे आप मान्य कर रहे हैं।
  • स्थिति
    [वैध, अमान्य, कैच-ऑल, अज्ञात, स्पैमट्रेप, दुरुपयोग, do_not_mail]
  • sub_status
    [antispam_system, greylisted, mail_server_temporary_error, forcible_disconnect, mail_server_did_not_respond, timeout_exceeded, failed_smtp_connection, mailbox_quota_exceeded, exception_occurred, possible_traps, role_based, global_suppression, mailbox_not_found, no_dns_entries, failed_syntax_check, possible_typo, unroutable_ip_address, leading_period_removed, does_not_accept_mail, alias_address]
  • लेखा
    "@" प्रतीक से पहले ईमेल पते का हिस्सा।
  • डोमेन
    "@" प्रतीक के बाद ईमेल पते का हिस्सा।
  • डिस्पोजेबल
    [सही, गलत] यदि ईमेल डोमेन डिस्पोजेबल है, जो आमतौर पर अस्थायी ईमेल पते हैं।
  • विषैला
    [सच, गलत] ये ईमेल पते दुर्व्यवहार, स्पैम या बॉट निर्मित होने के लिए जाने जाते हैं।
  • पहला नाम
    उपलब्ध या अशक्त होने पर ईमेल के स्वामी का पहला नाम।
  • उपनाम
    उपलब्ध या अशक्त होने पर ईमेल के स्वामी का अंतिम नाम।
  • लिंग
    उपलब्ध या अशक्त होने पर ईमेल के स्वामी का लिंग।
  • रचना तिथि
    जब उपलब्ध हो या [अशक्त] [अप्रचलित] ईमेल की निर्माण तिथि।
  • स्थान
    जब उपलब्ध हो या [अशक्त] [अप्रचलित] ईमेल के स्वामी का स्थान।
  • परिवर्तित यहाँ पर
    ईमेल को UTC समय मान्य किया गया था।

एपीआई इन अतिरिक्त क्षेत्रों को "वैलिडेटिथिप" का उपयोग करके लौटा देगा और इन अतिरिक्त अतिरिक्त क्षेत्रों को वैद्येटविथिप विधि का उपयोग करके लौटाएगा:

  • गुण
    विवरण
  • faridabad
    आईपी के शहर में पारित कर दिया।
  • क्षेत्र
    आईपी का क्षेत्र / राज्य अंदर चला गया।
  • पिन कोड
    आईपी का ज़िपकोड अंदर पारित हुआ।
  • देश
    आईपी के देश में पारित कर दिया।

मान्य कोड कोड नमूने

  • मूल दृश्य
  • C#
  • पीएचपी
  • जावा
  • अजगर
  • तीव्र
  • उद्देश्य सी
  • Android जावा
      
'पूरी एपीआई लाइब्रेरी और रैपर्स यहां देखे जा सकते हैं: 
' https://www.zerobounce.net/docs/zerobounce-api-wrappers/#api_wrappers__v2__dot_net

  प्रयत्न
  धुंधला apiKey जैसा तार = "आपकी गुप्त कुंजी"
  धुंधला emailToValidate जैसा तार = "example@example.कॉम"
  धुंधला responseString जैसा तार = ""
  धुंधला apiURL जैसा तार = "https://api.zerobounce.net/v1/validate?apikey=" & apiKey & "और ईमेल =" &  HttpUtility.UrlEncode(emailToValidate)
  'आईपी लुकअप के साथ वैकल्पिक एपीआई का उपयोग करने के लिए बाहर निकलना
  'Dim apiURL स्ट्रिंग के रूप में = "https://api.zerobounce.net/v1/validatewithip?apikey=" & apiKey &" & email = "& HttpUtility.UrlEncode (emailToValidate) &" & ipaddress = "& HttpUtility.UrlEncode (" 99.123.12.122 ")


  धुंधला request जैसा HttpWebRequest = Directcast(WebRequest.Create(apiURL), HttpWebRequest)
  request.समय समाप्त = 150000
  request.Method = "प्राप्त"

  का उपयोग करते हुए response जैसा WebResponse = request.GetResponse()
      response.GetResponseStream().ReadTimeout = 20000
      का उपयोग करते हुए ostream जैसा नया StreamReader(response.GetResponseStream())
          responseString = ostream.ReadToEnd()
      समाप्त का उपयोग करते हुए
  समाप्त का उपयोग करते हुए
पकड़ ex जैसा exception
'कैच एक्सेप्शन - सभी त्रुटियों को यहां दिखाया जाएगा - अगर एपीआई के साथ कोई समस्या है
समाप्त प्रयत्न

    

    // संपूर्ण एपीआई लाइब्रेरी और रैपर्स यहां देखे जा सकते हैं: 
    // https://www.zerobounce.net/docs/zerobounce-api-wrappers/#api_wrappers__v2__dot_net
    // https://www.zerobounce.net/docs/zerobounce-api-wrappers/#api_wrappers__v2__c-sharp

    प्रयत्न {
      तार apiKey = "आपकी गुप्त कुंजी";
      तार emailToValidate = "example@example.com";
      तार responseString = "";
          तार apiURL = "https://api.zerobounce.net/v1/validate?apikey=" + apiKey + "और ईमेल =" +  HttpUtility.Urlencode(emailToValidate);
      
              // आईपी लुकअप के साथ वैकल्पिक एपीआई का उपयोग करने के लिए बाहर निकलना
              // string apiURL = "https://api.zerobounce.net/v1/validatewithip?apikey=" + apiKey +" & email = "+ HttpUility.UrlEncode (emailToValidate; +" & ipaddress = "+ Http://tility.UrlEncode (" 99.123.12.122 "))
      
          Httpwebrequest request = (HttpWebRequest)WebRequest.सर्जन करना(apiURL);
          request.Timeout = 150000;
          request.Method = "प्राप्त";
      
          का उपयोग करते हुए (WebResponse response = request.प्रतिक्रिया हासिल करो()) {
              response.Getresponsestream().ReadTimeout = 20000;
              का उपयोग करते हुए (StreamReader ostream = नया StreamReader(response.Getresponsestream())) {
                  responseString = ostream.Readtoend();
              }
          }
          } पकड़ (exception ex) {
      // कैच एक्सेप्शन - सभी त्रुटियों को यहां दिखाया जाएगा - अगर एीआई के साथ कोई समस्या है
      }
    

    <?php
    // संपूर्ण एपीआई लाइब्रेरी और रैपर्स यहां देखे जा सकते हैं: 
    // https://www.zerobounce.net/docs/zerobounce-api-wrappers/#api_wrappers__v2__php

    
    // एपीआई कुंजी सेट करें और ईमेल को मान्य किया जाए
    $ apiKey = 'योर सीक्रेट की';
    $ emailToValidate = 'example@example.com';
    $ IPToValidate = '99.123.12.122';
    // अनुरोध करने के लिए कर्ल का उपयोग करें
    $ url = 'https://api.zerobounce.net/v1/validate?apikey='.$ apiKey.'और ईमेल ='.Urlencode($ emailToValidate);
    // आईपी लुकअप के साथ वैकल्पिक एपीआई का उपयोग करने के लिए बाहर निकलना
    // $ url = 'https://api.zerobounce.net/v1/validatewithip?apikey='.$apiKey.'&email='.urlencode($emailToValidate).'&ipaddress='.urlencode($IPToValidate);
    
    $ ch = curl_init($ url);
    //PHP तिरछी नज़रअनुप्रयोग 1} और उच्चतर टीएलएस  1.2 के लिए समर्थन है
    curl_setopt($ ch, CURLOPT_SSLVERSION, 6);
    curl_setopt($ ch, CURLOPT_RETURNTRANSFER, सच);
    curl_setopt($ ch, CURLOPT_CONNECTTIMEOUT, 15); 
    curl_setopt($ ch, CURLOPT_TIMEOUT, 150); 
    $ प्रतिक्रिया = curl_exec($ ch);
    curl_close($ ch);
    
    // json प्रतिक्रिया को डिकोड करें
    $ json = json_decode($ प्रतिक्रिया, सच);
    ?>
    


  // संपूर्ण एपीआई लाइब्रेरी और रैपर्स यहां देखे जा सकते हैं: 
  //https://www.zerobounce.net/docs/zerobounce-api-wrappers/#api_wrappers__v2__java

    आयात जावा.आईओ.Bufferedreader;
    आयात जावा.आईओ.Inputstreamreader;
    आयात जावा.जाल.Httpurlconnection;
    आयात जावा.जाल.URL;
    
    जनता कक्षा मेरी कक्षा {
    
        जनता स्थिर शून्य मुख्य(तार[] args){
    
            तार key = "आपकी गुप्त कुंजी";
            तार email = "example@example.com";
            तार ip = "99.123.12.122";
            तार targetURL = "https://api.zerobounce.net/v1/validate?apikey="+key+"और ईमेल ="+email;
    // आईपी लुकअप के साथ वैकल्पिक एपीआई का उपयोग करने के लिए बाहर निकलना
    // स्ट्रिंग targetURL = "https://api.zerobounce.net/v1/validatewithip?apikey="+key+"&email="+email+"&ipaddress="+ip;
    
            Httpurlconnection connection = शून्य;
            अंतिम तार USER_AGENT = "मोज़िला / 5.0";
    
            प्रयत्न {
                यूआरएल url = नया यूआरएल(targetURL);
                connection = (Httpurlconnection) url.openconnection();
                connection.setrequestmethod("प्राप्त");
                connection.addrequestproperty("उपभोक्ता अभिकर्ता", USER_AGENT);
                connection.setusecaches(असत्य);
                connection.setdooutput(सच);
    
                Bufferedreader in = नया Bufferedreader(
                        नया Inputstreamreader(connection.getinputstream()));
                तार inputLine;
                StringBuffer response = नया StringBuffer();
    
                जबकि ((inputLine = in.पढ़ने के लिए लाइन()) != शून्य) {
                    response.जोड़ना(inputLine);
                }
                in.बंद करे();
    
                // प्रिंट परिणाम
                प्रणाली.out.println(response.toString());
    
            } पकड़ (अपवाद e) {
                e.printstacktrace();
            } आखिरकार {
                अगर (connection != शून्य) {
                    connection.डिस्कनेक्ट();
                }
            }
    
        }
    }
    

    # पूर्ण एपीआई लाइब्रेरी और रैपर्स यहां देखे जा सकते हैं: 
    # https://www.zerobounce.net/docs/zerobounce-api-wrappers/#api_wrappers__v2__python
    
    url = "https://api.zerobounce.net/v1/validate"
    apikey = "आपकी गुप्त कुंजी"
    email = "example@example.com"
    ipaddress = "99.123.12.122"
    
    params = {"ईमेल": email, "एपीआई कुंजी": apikey}
    
    # आईपी लुकअप के साथ वैकल्पिक एपीआई का उपयोग करने के लिए असुविधा
    # params ["ipaddress"] = ipaddress
    
    response = requests.get(url, params=params)
    
    # लौटे हुए जशन को प्रिंट करें
    छाप json.loads(response.content)
    
    


  // संपूर्ण एपीआई लाइब्रेरी और रैपर्स यहां देखे जा सकते हैं: 
  // https://www.zerobounce.net/docs/zerobounce-api-wrappers/#api_wrappers__v2__IOS

    चलो key = "आपकी गुप्त कुंजी"
    चलो email = "example@example.com"
    चलो url = यूआरएल(string: तार(format: "https://api.zerobounce.net/v1/validate?apikey=%@&email=%@", key, email))
    चलो ip = "99.123.12.122"
    // आईपी लुकअप के साथ वैकल्पिक एपीआई का उपयोग करने के लिए बाहर निकलना
    // url = URL (स्ट्रिंग: स्ट्रिंग (प्रारूप: "https://api.zerobounce.net/v1/validatewithip?apikey=%@&email=%@&ipaddress=%@", कुंजी, ईमेल, आईपी))
    चलो task = Urlsession.shared.datatask(with: url!) { (data, response, error) में
        अगर error != शून्य {
            NSLog("त्रुटि (स्ट्रिंग (वर्णन: त्रुटि))")
        } अन्य {
            करना {
                चलो parsedData = प्रयत्न Jsonserialization.JSONObject(with: data!) जैसा! [तार:कोई भी]
                के लिये (key, value) में parsedData {
                    NSLog("(कुंजी) = (मूल्य)")
                }
            } पकड़ {
                छाप("त्रुटि JSON का वर्णन करने में त्रुटि: (त्रुटि)")
            }
        }
    }
    task.बायोडाटा()
    


  // संपूर्ण एपीआई लाइब्रेरी और रैपर्स यहां देखे जा सकते हैं: 
  // https://www.zerobounce.net/docs/zerobounce-api-wrappers/#api_wrappers__v2__IOS


    NSString *key = @ "आपकी गुप्त कुंजी";
    NSString *email = @"example@example.com";
    NSString *ip = @"99.123.12.122";
    NSString *urlString = [NSString stringWithFormat:@"https://api.zerobounce.net/v1/validate?apikey=%@&email=%@", key, email];
    // NSString * urlString = [NSString stringWithFormat: @ "https://api.zerobounce.net/v1/validatewithip?apikey=%@&email=%@&ipaddress=%@", कुंजी, ईमेल, आईपी];
    // आईपी लुकअप के साथ वैकल्पिक एपीआई का उपयोग करने के लिए बाहर निकलना
    
    
    __block NSURL *url = [NSURL URLWithString:urlString];
    
    dispatch_async(dispatch_get_global_queue(DISPATCH_QUEUE_PRIORITY_DEFAULT, 0), ^{
    
        NSData *response = [NSData dataWithContentsOfURL:url];
        NSDictionary *arrResponse = nil;
        अगर(response!=nil)
        {
            arrResponse = [NSJSONSerialization JSONObjectWithData: response options:kNilOptions error:nil];
        }
        dispatch_async(dispatch_get_main_queue(), ^(शून्य) {
            के लिये(NSString *key में [arrResponse allKeys]) {
                NSLog(@"%@: %@",key,[arrResponse objectForKey:key]);
            }
    // कॉलबैक (nil, arr);
        });
    });
    



  // संपूर्ण एपीआई लाइब्रेरी और रैपर्स यहां देखे जा सकते हैं: 
  // https://www.zerobounce.net/docs/zerobounce-api-wrappers/#api_wrappers__v2__android

    // "android" ब्रैकेट में build.gradle (ऐप) में जोड़ें:
    useLibrary 'org.apache.http.legacy'
    
    //उदाहरण:
    
    android {
        compileSdkVersion 25
        useLibrary 'org.apache.http.legacy'
    }
    
    //-----------------------------------
    
    // फ़ाइल नाम: JsonParser.java
    
    
    आयात एंड्रॉयड.ओएस.Asynctask;
    आयात org.json.JSONObject;
    आयात जावा.util.इटरेटर;
    
    जनता कक्षा मुख्य गतिविधि का विस्तार Appcompatactivity {
    
        @override
        संरक्षित शून्य OnCreate(बंडल savedInstanceState) {
            सुपर.OnCreate(savedInstanceState);
    
            नया Asynctaskparsejson().निष्पादित();
        }
    }
    
    जनता कक्षा Asynctaskparsejson का विस्तार Asynctask<तार, तार, तार> {
    
        तार key = "आपकी गुप्त कुंजी";
        तार email = "example@example.com";
        तार ip = "99.123.12.122";
        तार url = "https://api.zerobounce.net/v1/validate?apikey="+key+"और ईमेल ="+email;
    // आईपी लुकअप के साथ वैकल्पिक एपीआई का उपयोग करने के लिए बाहर निकलना
    // स्ट्रिंग url = "https://api.zerobounce.net/v1/validatewithip?apikey="+key+"&email="+email+"&ipaddress="+ip;
    
        @override
        संरक्षित शून्य onpreexecute() {
        }
    
        @override
        संरक्षित तार doinbackground(तार... arg0) {
    
            Jsonparser jParser = नया Jsonparser();
            JSONObject json = jParser.getjsonfromurl(url);
            इटरेटर keys = json.चांबियाँ();
            जबकि( keys.hasnext() ) {
                तार key = (तार)keys.आगे();
                प्रयत्न {
                    प्रणाली.out.println("शून्य:"+key+" = " +json.प्राप्त(key).toString());
                }
                पकड़ (अपवाद e){}
            }
    
            वापसी शून्य;
        }
        @override
        संरक्षित शून्य onpostexecute(तार strFromDoInBg) {}
    }
    
    //----------------------------------
    
    // फ़ाइल नाम: MainActivity.java
    
    पैकेज कॉम.Zerobounce.zbapiandroid;
    
    आयात जावा.आईओ.Bufferedreader;
    आयात जावा.आईओ.IOException;
    आयात जावा.आईओ.आगत प्रवाह;
    आयात जावा.आईओ.Inputstreamreader;
    आयात जावा.आईओ.Unsupportedencodingexception;
    
    आयात org.अमरीका की एक मूल जनजाति.एचटीटीपी.Httpentity;
    आयात org.अमरीका की एक मूल जनजाति.एचटीटीपी.HttpResponse;
    आयात org.अमरीका की एक मूल जनजाति.एचटीटीपी.ग्राहक.Clientprotocolexception;
    आयात org.अमरीका की एक मूल जनजाति.एचटीटीपी.ग्राहक.तरीकों.Httpget;
    आयात org.अमरीका की एक मूल जनजाति.एचटीटीपी.impl.ग्राहक.Defaulthttpclient;
    आयात org.json.Jsonexception;
    आयात org.json.JSONObject;
    
    आयात एंड्रॉयड.util.लॉग;
    
    जनता कक्षा Jsonparser {
    
        अंतिम तार TAG = "Jsonparser.java";
    
        स्थिर आगत प्रवाह is = शून्य;
        स्थिर JSONObject jObj = शून्य;
        स्थिर तार json = "";
    
        जनता JSONObject getjsonfromurl(तार url) {
    
            प्रयत्न {
    
                Defaulthttpclient httpClient = नया Defaulthttpclient();
                Httpget httpGet = नया Httpget(url);
    
                HttpResponse httpResponse = httpClient.निष्पादित(httpGet);
                Httpentity httpEntity = httpResponse.getentity();
                is = httpEntity.सामग्री लो();
    
            } पकड़ (Unsupportedencodingexception e) {
                e.printstacktrace();
            } पकड़ (Clientprotocolexception e) {
                e.printstacktrace();
            } पकड़ (IOException e) {
                e.printstacktrace();
            }
    
            प्रयत्न {
    
                Bufferedreader reader = नया Bufferedreader(नया Inputstreamreader(is, "आईएसओ 8859-1"), 8);
                Stringbuilder sb = नया Stringbuilder();
                तार line = शून्य;
                जबकि ((line = reader.पढ़ने के लिए लाइन()) != शून्य) {
                    sb.जोड़ना(line + "
");
                }
                is.बंद करे();
                json = sb.toString();
    
            } पकड़ (अपवाद e) {
                लॉग.e(TAG, "परिणाम परिवर्तित करने में त्रुटि" + e.toString());
            }
    
            प्रयत्न {
                jObj = नया JSONObject(json);
            } पकड़ (Jsonexception e) {
                लॉग.e(TAG, "डेटा पार्स करने में त्रुटि" + e.toString());
            }
    
            वापसी jObj;
        }
    }
    

समापन बिंदु प्रतिक्रिया

सफल प्रतिक्रिया

      
    {
      "पता":"flowerjill@aol.com",
      "स्थिति":"वैध",
      "sub_status":"",         
      "लेखा":"flowerjill",
      "डोमेन":"aol.com",
      "डिस्पोजेबल":असत्य,
      "विषाक्त":असत्य,
      "पहला नाम":"जिल",
      "उपनाम":"स्टीन",
      "लिंग":"महिला",
      "स्थान":शून्य,
      "रचना तिथि":शून्य,
      "परिवर्तित यहाँ पर":"2017-04-01 02:48:02.592"
     }
    

आईपी के साथ सफल प्रतिक्रिया

      
    {
      "पता":"flowerjill@aol.com",
      "स्थिति":"वैध",
      "sub_status":"", 
      "लेखा":"flowerjill",
      "डोमेन":"aol.com",
      "डिस्पोजेबल":असत्य,
      "विषाक्त":असत्य,
      "पहला नाम":"जिल",
      "उपनाम":"स्टीन",
      "लिंग":"महिला",
      "स्थान":शून्य,
      "देश":"संयुक्त राज्य अमेरिा",
      "क्षेत्र":"फ्लोरिडा",
      "faridabad":"वेस्ट पाम बीच",
      "पिन कोड":"33401",
      "रचना तिथि":शून्य,
      "परिवर्तित यहाँ पर":"2017-04-01 02:48:02.592"
      }
    

त्रुटि प्रतिक्रिया

      
    {"त्रुटि":"अमान्य API कुंजी या आपका खात क्रेडिट से बाहर चला गया"}