Verwendung der ZeroBounce-API

E-Mails validieren (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.

Testen oder API ohne Verwendung von Credits - Verwenden Sie die E-Mails in unserer Sandbox-Dokumentation.

Die Antwortzeit für unsere API liegt zwischen einer Sekunde und 70 Sekunden. Da APIs von Natur aus schnell sein sollen, begrenzen wir den Zeitaufwand für die Überprüfung einer E-Mail-Adresse. Wenn wir also auf einen langsamen Mailserver oder einen Mailserver mit einem Greylisting-Algorithmus stoßen, erhalten Sie ein unbekanntes Ergebnis. Sie können diese Bedingungen jederzeit erneut überprüfen und eine Datei in den Massen-E-Mail-Validator hochladen.

Im Durchschnitt werden 96-98% aller Domains in 1 bis 5 Sekunden zurückgegeben. Es gibt eine Handvoll Domains, die Postfix / Dovecot ausführen und eine Verbindungszeit von 20 Sekunden für Echtzeitüberprüfungen und eine sehr lange haben kleiner Bruchteil der anderen Domänen, die nur sehr langsam auf SMTP-Anfragen antworten. Alle wichtigen ISPs kehren in 1 bis 3 Sekunden zurück, was normalerweise die Mehrheit der meisten E-Mail-Distributionen darstellt.

GET / v1 / validate

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

API-URL (mit GEO-Anhang): https://bulkapi.zerobounce.net/v1/validatewithip

URL-Parameter

  • Parameter
    Beschreibung
  • EMAIL
    Die E-Mail-Adresse, die Sie überprüfen möchten
  • ipaddress
    Die IP-Adresse, unter der sich die E-Mail angemeldet hat (Kann leer sein, aber Parameter erforderlich)
  • apikey
    Ihr API-Schlüssel befindet sich in Ihrem Konto

Wenn Sie die API von Ihrem Browser aus aufrufen möchten, um sie zu testen, müssen Sie lediglich den API-SCHLÜSSEL durch Ihren Schlüssel ersetzen:

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

oder wenn Sie GEO Append nicht benötigen, rufen Sie einfach die validate-Methode auf.

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

Die API gibt diese Ergebnisse in einem JSON-Format mit der Methode "Validate" zurück.

  • Eigenschaften
    Beschreibung
  • adresse
    Die E-Mail-Adresse, die Sie validieren.
  • status
    [gültig, ungültig, allumfassend, unbekannt, spamfalle, missbrauch, do_not_mail]
  • sub_status
    [antispam_system, greylist, 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]
  • konto
    Der Teil der E-Mail-Adresse vor dem Symbol "@".
  • Domain
    Der Teil der E-Mail-Adresse nach dem Symbol "@".
  • wegwerf
    [true, false] Wenn die E-Mail-Domain verfügbar ist, handelt es sich normalerweise um temporäre E-Mail-Adressen.
  • giftig
    [wahr, falsch] Bei diesen E-Mail-Adressen handelt es sich bekanntermaßen um Missbrauch, Spam oder Bot.
  • vorname
    Der Vorname des Inhabers der E-Mail, falls verfügbar oder [null].
  • nachname
    Der Nachname des Inhabers der E-Mail, falls verfügbar oder [null].
  • geschlecht
    Das Geschlecht des Inhabers der E-Mail, sofern verfügbar oder [null].
  • Erstellungsdatum
    Das Erstellungsdatum der E-Mail, sofern verfügbar, oder [null] [veraltet].
  • lage
    Der Speicherort des Inhabers der E-Mail, sofern verfügbar oder [null] [veraltet].
  • verarbeitetAt
    Die UTC-Zeit, zu der die E-Mail validiert wurde.

Die API gibt diese zusätzlichen Felder unter Verwendung der "validatewithip" zurück. Gibt diese zusätzlichen zusätzlichen Felder unter Verwendung der validatewithip-Methode zurück:

  • Eigenschaften
    Beschreibung
  • stadt
    Die Stadt des IP ging vorbei.
  • region
    Die Region / der Status der übergebenen IP.
  • postleitzahl
    Die Postleitzahl der übergebenen IP.
  • land
    Das Land der IP wurde übergeben.

Überprüfen Sie E-Mail-Codebeispiele

  • Visuelle Basis
  • C#
  • PHP
  • Java
  • Python
  • Schnell
  • Ziel c
  • Android Java
      
'Vollständige API-Bibliotheken und Wrapper finden Sie hier: 
' https://www.zerobounce.net/docs/zerobounce-api-wrappers/#api_wrappers__v2__dot_net

  VERSUCHEN
  Dim apiKey WIE Zeichenfolge = "Dein geheimer Schlüssel"
  Dim emailToValidate WIE Zeichenfolge = "example@example.com"
  Dim responseString WIE Zeichenfolge = ""
  Dim apiURL WIE Zeichenfolge = "https://api.zerobounce.net/v1/validate?apikey=" & apiKey & "& email =" &  HttpUtility.UrlEncode(emailToValidate)
  'Kommentieren Sie die Verwendung der optionalen API mit IP-Suche aus
  'Dim apiURL as string = "https://api.zerobounce.net/v1/validatewithip?apikey=" & apiKey &" & email = "& HttpUtility.UrlEncode (emailToValidate) &" & ipaddress = "& HttpUtility.UrlEncode (" 99.123.12.122 ")


  Dim request WIE HttpWebRequest = Direktübertragung(WebRequest.Create(apiURL), HttpWebRequest)
  request.Auszeit = 150000
  request.Method = "BEKOMMEN"

  Verwenden response WIE WebResponse = request.GetResponse()
      response.GetResponseStream().ReadTimeout = 20000
      Verwenden ostream WIE NEU StreamReader(response.GetResponseStream())
          responseString = ostream.ReadToEnd()
      ENDE Verwenden
  ENDE Verwenden
Fang ex WIE exception
'Catch Exception - Alle Fehler werden hier angezeigt - wenn es Probleme mit der API gibt
ENDE VERSUCHEN

    

    // Vollständige API-Bibliotheken und Wrapper finden Sie hier: 
    // 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

    VERSUCHEN {
      Zeichenfolge apiKey = "Dein geheimer Schlüssel";
      Zeichenfolge emailToValidate = "example@example.com";
      Zeichenfolge responseString = "";
          Zeichenfolge apiURL = "https://api.zerobounce.net/v1/validate?apikey=" + apiKey + "& email =" +  HttpUtility.Urlencode(emailToValidate);
      
              // Kommentieren Sie aus, um die optionale API mit IP-Suche zu verwenden
              // string apiURL = "https://api.zerobounce.net/v1/validatewithip?apikey=" + apiKey +" & email = "+ HttpUility.UrlEncode (emailToValidate); +" & ipaddress = "+ HttpUtility.UrlEncode (" 99.123.12.122 ")
      
          Httpwebrequest request = (HttpWebRequest)WebRequest.erstellen(apiURL);
          request.Timeout = 150000;
          request.Method = "BEKOMMEN";
      
          Verwenden (Antwort response = request.Erhalten Antwort()) {
              response.Getresponsestream().ReadTimeout = 20000;
              Verwenden (Streamreader ostream = NEU Streamreader(response.Getresponsestream())) {
                  responseString = ostream.Readtoend();
              }
          }
          } Fang (exception ex) {
      // Catch Exception - Alle Fehler werden hier angezeigt - wenn es Probleme mit der API gibt
      }
    

    <?php
    // Vollständige API-Bibliotheken und Wrapper finden Sie hier: 
    // https://www.zerobounce.net/docs/zerobounce-api-wrappers/#api_wrappers__v2__php

    
    // setze den api-schlüssel und die zu validierende e-mail
    $ apiKey = "Dein geheimer Schlüssel";
    $ emailToValidate = 'example@example.com';
    $ IPToValidate = '99.123.12.122';
    // benutze curl um die anfrage zu stellen
    $ url = 'https://api.zerobounce.net/v1/validate?apikey='.$ apiKey.'& email ='.Urlencode($ emailToValidate);
    // Kommentieren Sie aus, um die optionale API mit IP-Suche zu verwenden
    // $ url = 'https://api.zerobounce.net/v1/validatewithip?apikey='.$apiKey.'&email='.urlencode($emailToValidate).'&ipaddress='.urlencode($IPToValidate);
    
    $ ch = curl_init($ url);
    //PHP 5.5.19 und höher unterstützt TLS  1.2
    curl_setopt($ ch, CURLOPT_SSLVERSION, 6);
    curl_setopt($ ch, CURLOPT_RETURNTRANSFER, Wahr);
    curl_setopt($ ch, CURLOPT_CONNECTTIMEOUT, 15); 
    curl_setopt($ ch, CURLOPT_TIMEOUT, 150); 
    $ antwort = curl_exec($ ch);
    curl_close($ ch);
    
    // dekodiere die json-antwort
    $ json = json_decode($ antwort, Wahr);
    ?>
    


  // Vollständige API-Bibliotheken und Wrapper finden Sie hier: 
  //https://www.zerobounce.net/docs/zerobounce-api-wrappers/#api_wrappers__v2__java

    einführen Java.io.Gepufferter Leser;
    einführen Java.io.Inputstreamreader;
    einführen Java.netz.Httpurlconnection;
    einführen Java.netz.URL;
    
    Öffentlichkeit Klasse Meine Klasse {
    
        Öffentlichkeit statisch leere main(Zeichenfolge[] args){
    
            Zeichenfolge key = "Dein geheimer Schlüssel";
            Zeichenfolge email = "example@example.com";
            Zeichenfolge ip = "99.123.12.122";
            Zeichenfolge targetURL = "https://api.zerobounce.net/v1/validate?apikey="+key+"& email ="+email;
    // Kommentieren Sie aus, um die optionale API mit IP-Suche zu verwenden
    // String targetURL = "https://api.zerobounce.net/v1/validatewithip?apikey="+key+"&email="+email+"&ipaddress="+ip;
    
            Httpurlconnection connection = null;
            finale Zeichenfolge USER_AGENT = "Mozilla / 5.0";
    
            VERSUCHEN {
                url url = NEU url(targetURL);
                connection = (Httpurlconnection) url.offene Verbindung();
                connection.setrequestmethod("BEKOMMEN");
                connection.addrequestproperty("User-Agent", USER_AGENT);
                connection.setusecaches(Falsch);
                connection.setdooutput(Wahr);
    
                Gepufferter Leser in = NEU Gepufferter Leser(
                        NEU Inputstreamreader(connection.getinputstream()));
                Zeichenfolge inputLine;
                Stringbuffer response = NEU Stringbuffer();
    
                während ((inputLine = in.Zeile lesen()) != null) {
                    response.anhängen(inputLine);
                }
                in.schließen();
    
                // ergebnis drucken
                System.out.println(response.toString());
    
            } Fang (Ausnahme e) {
                e.printstacktrace();
            } endlich {
                OB (connection != null) {
                    connection.trennen();
                }
            }
    
        }
    }
    

    # Vollständige API-Bibliotheken und Wrapper finden Sie hier: 
    # https://www.zerobounce.net/docs/zerobounce-api-wrappers/#api_wrappers__v2__python
    
    url = "https://api.zerobounce.net/v1/validate"
    apikey = "Dein geheimer Schlüssel"
    email = "example@example.com"
    ipaddress = "99.123.12.122"
    
    params = {"email": email, "api-schlüssel": apikey}
    
    # Kommentar zur Verwendung der optionalen API mit IP-Suche
    # params ["ipaddress"] = ipaddress
    
    response = requests.get(url, params=params)
    
    # Drucken Sie den zurückgegebenen JSON aus
    drucken json.loads(response.content)
    
    


  // Vollständige API-Bibliotheken und Wrapper finden Sie hier: 
  // https://www.zerobounce.net/docs/zerobounce-api-wrappers/#api_wrappers__v2__IOS

    lassen key = "Dein geheimer Schlüssel"
    lassen email = "example@example.com"
    lassen url = url(string: Zeichenfolge(format: "https://api.zerobounce.net/v1/validate?apikey=%@&email=%@", key, email))
    lassen ip = "99.123.12.122"
    // Kommentieren Sie aus, um die optionale API mit IP-Suche zu verwenden
    // lass url = URL (string: String (Format: "https://api.zerobounce.net/v1/validatewithip?apikey=%@&email=%@&ipaddress=%@", Schlüssel, E-Mail, IP))
    lassen task = Urlsession.shared.Datenaufgabe(with: url!) { (data, response, error) im
        OB error != null {
            Nslog("Fehler (Zeichenfolge (Beschreibung: Fehler))")
        } sonst {
            machen {
                lassen parsedData = VERSUCHEN Jsonserialization.jsonobject(with: data!) WIE! [Zeichenfolge:Irgendein]
                zum (key, value) im parsedData {
                    Nslog("(schlüssel) = (wert)")
                }
            } Fang {
                drucken("Fehler beim Deserialisieren von JSON: (Fehler)")
            }
        }
    }
    task.fortsetzen()
    


  // Vollständige API-Bibliotheken und Wrapper finden Sie hier: 
  // https://www.zerobounce.net/docs/zerobounce-api-wrappers/#api_wrappers__v2__IOS


    NSString *key = @ "Dein geheimer Schlüssel";
    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=%@", Schlüssel, E-Mail, IP];
    // Kommentieren Sie aus, um die optionale API mit IP-Suche zu verwenden
    
    
    __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;
        OB(response!=nil)
        {
            arrResponse = [NSJSONSerialization JSONObjectWithData: response options:kNilOptions error:nil];
        }
        dispatch_async(dispatch_get_main_queue(), ^(leere) {
            zum(NSString *key im [arrResponse allKeys]) {
                Nslog(@"%@: %@",key,[arrResponse objectForKey:key]);
            }
    // rückruf (nil, arr);
        });
    });
    



  // Vollständige API-Bibliotheken und Wrapper finden Sie hier: 
  // https://www.zerobounce.net/docs/zerobounce-api-wrappers/#api_wrappers__v2__android

    // Zu build.gradle (App) in der Klammer "android" hinzufügen:
    useLibrary 'org.apache.http.legacy'
    
    //Beispiel:
    
    android {
        compileSdkVersion 25
        useLibrary 'org.apache.http.legacy'
    }
    
    //-----------------------------------
    
    // Dateiname: JsonParser.java
    
    
    einführen android.os.Asynctask;
    einführen org.json.jsonobject;
    einführen Java.util.Iterator;
    
    Öffentlichkeit Klasse Hauptaktivität erweitert App-Kompatibilität {
    
        @override
        geschützt leere oncreate(Bündeln savedInstanceState) {
            super.oncreate(savedInstanceState);
    
            NEU Asynctaskparsejson().ausführen();
        }
    }
    
    Öffentlichkeit Klasse Asynctaskparsejson erweitert Asynctask<Zeichenfolge, Zeichenfolge, Zeichenfolge> {
    
        Zeichenfolge key = "Dein geheimer Schlüssel";
        Zeichenfolge email = "example@example.com";
        Zeichenfolge ip = "99.123.12.122";
        Zeichenfolge url = "https://api.zerobounce.net/v1/validate?apikey="+key+"& email ="+email;
    // Kommentieren Sie aus, um die optionale API mit IP-Suche zu verwenden
    // String url = "https://api.zerobounce.net/v1/validatewithip?apikey="+key+"&email="+email+"&ipaddress="+ip;
    
        @override
        geschützt leere onpreexecute() {
        }
    
        @override
        geschützt Zeichenfolge Hintergrund(Zeichenfolge... arg0) {
    
            Jsonparser jParser = NEU Jsonparser();
            jsonobject json = jParser.getjsonfromurl(url);
            Iterator keys = json.schlüssel();
            während( keys.hasnext() ) {
                Zeichenfolge key = (Zeichenfolge)keys.nächster();
                VERSUCHEN {
                    System.out.println("ZeroBounce:"+key+" = " +json.bekommen(key).toString());
                }
                Fang (Ausnahme e){}
            }
    
            Rückkehr null;
        }
        @override
        geschützt leere onpostexecute(Zeichenfolge strFromDoInBg) {}
    }
    
    //----------------------------------
    
    // Dateiname: MainActivity.java
    
    paket com.Zerobounce.zbapiandroid;
    
    einführen Java.io.Gepufferter Leser;
    einführen Java.io.Ioexception;
    einführen Java.io.Eingabestrom;
    einführen Java.io.Inputstreamreader;
    einführen Java.io.Unsupportedencodingexception;
    
    einführen org.apache.http.Httpentity;
    einführen org.apache.http.Httpresponse;
    einführen org.apache.http.klient.Clientprotocolexception;
    einführen org.apache.http.klient.methoden.Httpget;
    einführen org.apache.http.impl.klient.Defaulthttpclient;
    einführen org.json.Jsonexception;
    einführen org.json.jsonobject;
    
    einführen android.util.Log;
    
    Öffentlichkeit Klasse Jsonparser {
    
        finale Zeichenfolge TAG = "jsonparser.java";
    
        statisch Eingabestrom is = null;
        statisch jsonobject jObj = null;
        statisch Zeichenfolge json = "";
    
        Öffentlichkeit jsonobject getjsonfromurl(Zeichenfolge url) {
    
            VERSUCHEN {
    
                Defaulthttpclient httpClient = NEU Defaulthttpclient();
                Httpget httpGet = NEU Httpget(url);
    
                Httpresponse httpResponse = httpClient.ausführen(httpGet);
                Httpentity httpEntity = httpResponse.Getentität();
                is = httpEntity.Inhalt bekommen();
    
            } Fang (Unsupportedencodingexception e) {
                e.printstacktrace();
            } Fang (Clientprotocolexception e) {
                e.printstacktrace();
            } Fang (Ioexception e) {
                e.printstacktrace();
            }
    
            VERSUCHEN {
    
                Gepufferter Leser reader = NEU Gepufferter Leser(NEU Inputstreamreader(is, "iso- 8859-1"), 8);
                Stringbuilder sb = NEU Stringbuilder();
                Zeichenfolge line = null;
                während ((line = reader.Zeile lesen()) != null) {
                    sb.anhängen(line + "
");
                }
                is.schließen();
                json = sb.toString();
    
            } Fang (Ausnahme e) {
                Log.e(TAG, "Fehler beim Konvertieren des Ergebnisses" + e.toString());
            }
    
            VERSUCHEN {
                jObj = NEU jsonobject(json);
            } Fang (Jsonexception e) {
                Log.e(TAG, "Fehler beim Parsen von Daten" + e.toString());
            }
    
            Rückkehr jObj;
        }
    }
    

Endpunktantwort

Erfolgreiche Antwort

      
    {
      "adresse":"flowerjill@aol.com",
      "status":"gültig",
      "sub_status":"",         
      "konto":"flowerjill",
      "domain":"aol.com",
      "einweg":Falsch,
      "giftig":Falsch,
      "vorname":"jill",
      "nachname":"Stein",
      "geschlecht":"weiblich",
      "ort":null,
      "erstellungsdatum":null,
      "verarbeitet bei":"2017-04-01 02:48:02.592"
     }
    

Erfolgreiche Antwort mit IP

      
    {
      "adresse":"flowerjill@aol.com",
      "status":"gültig",
      "sub_status":"", 
      "konto":"flowerjill",
      "domain":"aol.com",
      "einweg":Falsch,
      "giftig":Falsch,
      "vorname":"jill",
      "nachname":"Stein",
      "geschlecht":"weiblich",
      "ort":null,
      "land":"Vereinigte Staaten",
      "region":"Florida",
      "stadt":"West Palm Beach",
      "postleitzahl":"33401",
      "erstellungsdatum":null,
      "verarbeitet bei":"2017-04-01 02:48:02.592"
      }
    

Fehlerantwort

      
    {"error":"Ungültiger API-Schlüssel oder Ihrem Konto sind die Credits ausgegangen."}