Single Email Validator - Echtzeit (v2)

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 - Bitte verwenden Sie die E-Mails in unserem Sandbox-Modus (v2)

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 das Verzeichnis hochladen Massen-E-Mail-Validator .

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 / v2 / validate

API-URL: https://api.zerobounce.net/v2/validate

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.

URL-Parameter

  • Parameter
    Beschreibung
  • EMAIL
    Die E-Mail-Adresse, die Sie überprüfen möchten
  • ip adresse
    Die IP-Adresse, unter der sich die E-Mail angemeldet hat (Kann leer sein, aber Parameter erforderlich)
  • api-schlüssel
    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/v2/validate?api_key=replacewithyours&email=valid@example.com&ip_address=156.124.12.145

Verwenden Sie zum Überprüfen einer E-Mail-Adresse die folgenden Codes für die folgenden Sprachen:

  • 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 api_key WIE Zeichenfolge = "Dein geheimer Schlüssel"
    Dim emailToValidate WIE Zeichenfolge = "example@example.com"
    Dim ip_address = "" 'Kann leer sein, aber Parameter für den API-Aufruf erforderlich
    Dim responseString WIE Zeichenfolge = ""
  
    Dim apiURL WIE Zeichenfolge = "https://api.zerobounce.net/v2/validate?api_key=" & api_key & "& email =" &  HttpUtility.UrlEncode(emailToValidate) & "& ip_address =" & System.Net.WebUtility.UrlEncode(ip_address)
  
    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 api_key = "Dein geheimer Schlüssel";
  Zeichenfolge emailToValidate = "example@example.com";
  Zeichenfolge ip_address = "" // Kann leer sein, aber Parameter für den API-Aufruf erforderlich
  
  Zeichenfolge responseString = "";
  
  Zeichenfolge apiURL = "https://api.zerobounce.net/v2/validate?api_key=" + api_key + "& email =" +  HttpUtility.Urlencode(emailToValidate) + "& ip_address =" + HttpUtility.Urlencode(ip_address);
  
  
      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
  $ api_key = "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/v2/validate?api_key='.$ api_key.'& email ='.Urlencode($ emailToValidate).'& ip_address ='.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"; // ip-adresse kann leer sein
          Zeichenfolge targetURL = "https://api.zerobounce.net/v2/validate?api_key="+key+"& email ="+email+"& ip_address ="+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/v2/validate"
  api_key = "Dein geheimer Schlüssel"
  email = "example@example.com"
  ip_address = "99.123.12.122" #ip_address kann leer sein
  
  params = {"email": email, "api-schlüssel": api_key, "ip adresse":ip_address}
  
  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 ip = "99.123.12.122" // ip-adresse kann leer sein
  lassen url = url(string: Zeichenfolge(format: "https://api.zerobounce.net/v2/validate?api_key=%@&email=%@&ip_address=%@", key, email, 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"; // ip-adresse kann leer sein
  
  NSString *urlString = [NSString stringWithFormat:@"https://api.zerobounce.net/v2/validate?api_key=%@&email=%@&ip_address=%@", key, email, ip];
  
  __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"; // ip-adresse kann leer sein
      Zeichenfolge url = "https://api.zerobounce.net/v2/validate?api_key="+key+"& email ="+email+"& ip_address ="+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;
      }
    }
      

Erfolgreiche Antwort

      
  {
    "adresse":"flowerjill@aol.com",
    "status":"gültig",
    "sub_status":"",
    "free_email":Wahr,
    "hast du gemeint":null,
    "konto":"flowerjill",
    "domain":"aol.com",
    "domain_age_days": "8426",
    "smtp_provider":"yahoo",
    "mx_record":"mx-aol.mail.gm0.yahoodns.net",
    "mx_found": Wahr,
    "vorname":"jill",
    "nachname":"Stein",
    "geschlecht":"weiblich",
    "land":"Vereinigte Staaten",
    "region":"Florida",
    "stadt":"West Palm Beach",
    "postleitzahl":"33401",
    "process_at":"2017-04-01 02:48:02.592"
    }
      

Fehlerantwort

      
      {"error":"Ungültiger API-Schlüssel oder Ihrem Konto sind die Credits ausgegangen."}
      // Failure response sample using the API with either method Get
      

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

JSON-Eigenschaften

  • 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,
    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, role_based_catch_all, einweg, giftig]
  • konto
    Der Teil der E-Mail-Adresse vor dem Symbol "@".
  • Domain
    Der Teil der E-Mail-Adresse nach dem Symbol "@".
  • hast du gemeint
    Suggestive Korrektur für einen E-Mail-Tippfehler
  • domain_age_days
    Alter der E-Mail-Domain in Tagen oder [null].
  • free_email
    [wahr / falsch] Wenn die E-Mail von einem kostenlosen Anbieter stammt.
  • mx_found
    [true / false] Verfügt die Domain über einen MX-Eintrag?
  • mx_record
    Der bevorzugte MX-Eintrag der Domain
  • smtp_provider
    Der SMTP-Anbieter der E-Mail oder [null] [BETA].
  • 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].
  • stadt
    The city of the IP passed in or [null]
  • region
    The region/state of the IP passed in or [null]
  • postleitzahl
    The zipcode of the IP passed in or [null]
  • land
    The country of the IP passed in or [null]
  • verarbeitete_at
    Die UTC-Zeit, zu der die E-Mail validiert wurde.