API-Wrapper

Java

/ zerobounce-api-wrapper / v2-java /

Sie finden den offiziellen ZeroBounce Java API v2 Wrapper:

Offizielles JAVA SDK:

Dies ist ein Beispiel für eine Java-Wrapper-Klasse für die ZeroBounce-API v2.

Das Projekt hat 2 Abhängigkeiten:

  • Apache httpclient
  • Json (org.json)

Laden Sie die Abhängigkeiten entweder separat herunter und fügen Sie sie dem entsprechenden Pfad hinzu, oder fügen Sie der Datei pom.xml die folgenden Abhängigkeiten hinzu, wenn Sie über Maven erstellen (bereits hinzugefügt, wenn Sie dieses Repo klonen):

Validierungsmethode (E-Mail):

  • Eigenschaften
    Mögliche Werte
  • getEmailAddress ()
    Die E-Mail-Adresse, die Sie validieren.
  • Status bekommen()
    Gültig
    ungültig
    Allheilmittel
    unbekannte
    spamfalle
    missbrauch
    Donotmail
  • getSubStatus ()
    antispam_system
    grau gelistet
    mail_server_temporary_error
    forcible_disconnect
    mail_server_did_not_respond
    timeout_exceeded
    failed_smtp_connection
    postfach-kontingent überschritten
    ausnahme aufgetreten
    mögliche_fallen
    rollenbasiert
    globale unterdrückung
    mailbox_not_found
    no_dns_entries
    failed_syntax_check
    möglicher_typ
    unroutable_ip_address
    leading_period_removed
    does_not_accept_mail
    alias_address
    role_based_catch_all
  • getAccount ()
    Der Teil der E-Mail-Adresse vor dem Symbol "@".
  • getDomain ()
    Der Teil der E-Mail-Adresse nach dem Symbol "@".
  • getDidYouMean ()
    Suggestive Korrektur für einen E-Mail-Tippfehler oder [null]
  • getDomainAgeDays ()
    Alter der E-Mail-Domain in Tagen oder [null].
  • isFreeEmail ()
    [wahr / falsch] Wenn die E-Mail von einem kostenlosen Anbieter stammt.
  • isMXFound ()
    [true / false] Verfügt die Domain über einen MX-Eintrag?
  • getMXRecord ()
    Der bevorzugte MX-Eintrag der Domain oder [null].
  • getSMTPProvider ()
    Der SMTP-Anbieter der E-Mail oder [null] (BETA).
  • getFirstName ()
    Der Vorname des Inhabers der E-Mail, falls verfügbar oder [null].
  • getLastName ()
    Der Nachname des Inhabers der E-Mail, falls verfügbar oder [null].
  • getGender ()
    Das Geschlecht des Inhabers der E-Mail, sofern verfügbar oder [null].
  • getCountry ()
    Das Land, aus dem die IP-Adresse stammt.
  • getCity ()
    Die Stadt, aus der die IP-Adresse stammt.
  • getZipcode ()
    Die Postleitzahl, von der die IP-Adresse stammt.
  • getRegion ()
    Die Region / der Status, aus der / der die IP-Adresse stammt.
  • getProcessedAt ()
    Die UTC-Zeit, zu der die E-Mail validiert wurde.

Methode getCredit ()

  • Eigenschaften
    Mögliche Werte
  • getCredits ()
    Die Anzahl der Credits, die für die E-Mail-Validierung auf dem Konto verbleiben

  // Je nachdem, wie Sie die API verwenden, möchten Sie möglicherweise eine schnellere Zeitüberschreitung.
  // zum beispiel auf einem registrierungsbildschirm. 
  // Normalerweise gibt die API sehr schnell Ergebnisse zurück, aber ein kleiner Prozentsatz von
  // mail-server brauchen mehr als 20 + sekunden, um zu antworten. 
  // Wenn die API eine Zeitüberschreitung aufweist, wird der Status "Unbekannt" und "Unbekannt" zurückgegeben 
  // ein substatus von "timeout_exceeded"  

  Zerobounceapi zeroBounceApi = NEU Zerobounceapi("YOUR_API_KEY",TIMEOUT_IN_SECONDS);

  // Credits holen und int Variable zuweisen
  int credits = zeroBounceApi.getcredits();

  // E-Mail validieren und Ergebnis einem ZeroBounceResponse-Objekt zuweisen

  Zerobounceresponse validation = zeroBounceApi.bestätigen("some@email.com", "some.ip.address kann leer sein");
  validation.getemailaddress();
  validation.Status bekommen();
  validation.ist wegwerfbar();
  validation.getcountry();
      

Javascript

/ zerobounce-api-wrapper / v2-javascript /

Sie finden die ZeroBounce JavaScript API v2 unten:

Das bestätigen und getCredits Methoden geben Objekte zurück, von denen Sie auf einfache Weise Eigenschaften abrufen können.

Von den Methoden zurückgegebene Eigenschaften und mögliche Werte:

methode validieren

  • Eigentum
    Mögliche Werte
  • adresse
    Die E-Mail-Adresse, die Sie validieren.
  • status
    Gültig
    ungültig
    Allheilmittel
    unbekannte
    spamfalle
    missbrauch
    do_not_mail
  • sub_status
    antispam_system
    grau gelistet
    mail_server_temporary_error
    forcible_disconnect
    mail_server_did_not_respond
    timeout_exceeded
    failed_smtp_connection
    postfach-kontingent überschritten
    ausnahme aufgetreten
    mögliche_fallen
    rollenbasiert
    globale unterdrückung
    mailbox_not_found
    no_dns_entries
    failed_syntax_check
    möglicher_typ
    unroutable_ip_address
    leading_period_removed
    does_not_accept_mail
    alias_address
    giftig
    wegwerf
    role_based_catch_all
  • 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 oder [null]
  • 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 oder [null]
  • smtp_provider
    Der SMTP-Anbieter der E-Mail oder [null] (BETA)
  • 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]
  • land
    Das Land, aus dem die IP-Adresse stammt
  • region
    Der Status / die Region, aus der die IP-Adresse stammt
  • stadt
    Die Stadt, aus der die IP-Adresse stammt
  • postleitzahl
    Die Postleitzahl, von der die IP-Adresse stammt
  • verarbeitete_at
    Die UTC-Zeit, zu der die E-Mail validiert wurde

GetCredit-Methode

  • Eigentum
    Mögliche Werte
  • kredite
    Die Anzahl der Credits, die für die E-Mail-Validierung auf dem Konto verbleiben.

  var Zerobounceapi = NEU Zerobounceapi(apiKey)
  Zerobounceapi.API-Schlüssel
  Zerobounceapi.getcredits()
  Zerobounceapi.bestätigen("some@email.com", "some.ip.address kann leer sein")
      

Python

/ zerobounce-api-wrapper / v2-python /

Unten finden Sie den offiziellen ZeroBounce Python API v2-Wrapper:

Das ZeroBounce Python SDK finden Sie unten:

Anwendungsbeispiel

Das bestätigen und get_credit Methoden geben Objekte zurück, von denen Sie auf einfache Weise Eigenschaften abrufen können.

Von den Methoden zurückgegebene Eigenschaften und mögliche Werte:

methode validieren

  • Eigentum
    Mögliche Werte
  • adresse
    Die E-Mail-Adresse, die Sie validieren.
  • status
    Gültig
    ungültig
    Allheilmittel
    unbekannte
    spamfalle
    missbrauch
    do_not_mail
  • sub_status
    antispam_system
    grau gelistet
    mail_server_temporary_error
    forcible_disconnect
    mail_server_did_not_respond
    timeout_exceeded
    failed_smtp_connection
    postfach-kontingent überschritten
    ausnahme aufgetreten
    mögliche_fallen
    rollenbasiert
    globale unterdrückung
    mailbox_not_found
    no_dns_entries
    failed_syntax_check
    möglicher_typ
    unroutable_ip_address
    leading_period_removed
    does_not_accept_mail
    alias_address
    giftig
    wegwerf
    role_based_catch_all
  • 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 oder [null]
  • 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 oder [null]
  • smtp_provider
    Der SMTP-Anbieter der E-Mail oder [null] (BETA)
  • 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]
  • land
    Das Land, aus dem die IP-Adresse stammt
  • region
    Der Status / die Region, aus der die IP-Adresse stammt
  • stadt
    Die Stadt, aus der die IP-Adresse stammt
  • postleitzahl
    Die Postleitzahl, von der die IP-Adresse stammt
  • verarbeitete_at
    Die UTC-Zeit, zu der die E-Mail validiert wurde

GetCredit-Methode

  • Eigentum
    Mögliche Werte
  • kredite
    Die Anzahl der Credits, die für die E-Mail-Validierung auf dem Konto verbleiben.

  von zerobounce einführen ZeroBounceAPI

  zba = ZeroBounceAPI('yourapikey____________')
  drucken zba.get_credits()
  resp1 = zba.validate('flowerjill@aol.com','123.145.124.12')
  
  drucken resp1
  {
  "adresse":"flowerjill@aol.com",
  "status":"gültig",
  "sub_status":"",
  "free_email":Wahr,
  "hast du gemeint":Keiner,
  "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"
  }
  
  drucken resp.firstname
  Jill
  
  drucken resp2.status
  valid
      
      

PHP

/ zerobounce-api-wrapper / v2-php /

Offizieller ZeroBounce API v2 Wrapper:

Offizielles PHP SDK:Vom Benutzer bereitgestellte Bibliotheken:

Dies ist ein Beispiel für eine PHP-Wrapper-Klasse für die ZeroBounce-API.

Anwendungsbeispiel:

Die Validierungsmethoden geben Objekte zurück, für die Sie get-Methoden aufrufen, die die relevanten Informationen zurückgeben. Bitte beachten Sie den Beispielcode auf der rechten Seite:

Das bestätigen und getCredits Methoden geben Objekte zurück, von denen Sie auf einfache Weise Eigenschaften abrufen können.

Von den Methoden zurückgegebene Eigenschaften und mögliche Werte:

methode validieren

  • Eigentum
    Mögliche Werte
  • adresse
    Die E-Mail-Adresse, die Sie validieren.
  • status
    Gültig
    ungültig
    Allheilmittel
    unbekannte
    spamfalle
    missbrauch
    do_not_mail
  • sub_status
    antispam_system
    grau gelistet
    mail_server_temporary_error
    forcible_disconnect
    mail_server_did_not_respond
    timeout_exceeded
    failed_smtp_connection
    postfach-kontingent überschritten
    ausnahme aufgetreten
    mögliche_fallen
    rollenbasiert
    globale unterdrückung
    mailbox_not_found
    no_dns_entries
    failed_syntax_check
    möglicher_typ
    unroutable_ip_address
    leading_period_removed
    does_not_accept_mail
    alias_address
    giftig
    wegwerf
    role_based_catch_all
  • 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 oder [null]
  • 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 oder [null]
  • smtp_provider
    Der SMTP-Anbieter der E-Mail oder [null] (BETA)
  • 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]
  • land
    Das Land, aus dem die IP-Adresse stammt
  • region
    Der Status / die Region, aus der die IP-Adresse stammt
  • stadt
    Die Stadt, aus der die IP-Adresse stammt
  • postleitzahl
    Die Postleitzahl, von der die IP-Adresse stammt
  • verarbeitete_at
    Die UTC-Zeit, zu der die E-Mail validiert wurde

GetCredit-Methode

  • Eigentum
    Mögliche Werte
  • kredite
    Die Anzahl der Credits, die für die E-Mail-Validierung auf dem Konto verbleiben.

  <?php
  einmalig benötigt("zerobounce.php");
  
  $ zba = NEU Zerobounceapi('YOUR_API_KEY');
  
  // guthaben ausdrucken
  print_r($ zba->get_credits());
  
  // ein validierungsobjekt nach einem aufruf von instanziieren 
  // einzelne elemente validieren und drucken
  $ validierung = $ zba->bestätigen('email@address.com', 'IP kann leer sein');
  echo $ validierung['adresse'];
  echo $ validierung['status'];
  print_r($ zba->bestätigen('email@address.com', 'IP'));
  ?>
      

PHP 7

/ zerobounce-api-wrapper / v2-php7 /

Sie finden diesen vom Benutzer beigesteuerten PHP7-Wrapper unten:

Voraussetzungen Sie benötigen ein aktives Konto bei https://zerobounce.net, um diese Bibliothek nutzen zu können. Holen Sie sich von dort aus Ihren API-Schlüssel unter API - Keys & Info.

Installation Um dies in Ihr Projekt aufzunehmen, installieren Sie es mit Composer.

Da wir Rückgabetypen und Typhinweise verwenden, benötigt diese Bibliothek PHP 7.1.

komponisten benötigen nickdnk / zerobounce-php

Tests Geben Sie Ihren API-Schlüssel in die ZeroBounceTest-Datei ein und führen Sie ihn aus. Dies verwendet die von ZeroBounce bereitgestellten Test-E-Mails und kostet Sie kein Guthaben.


  benutzen nickdnkzerobounceemail;
  benutzen nickdnkzerobounceresult;
  benutzen nickdnkzerobouncezerobounce;
  
  // Sie können das Timeout mit dem zweiten Parameter ändern. Standard ist 15.
  $ handler = NEU Zerobounce('my_api_key', 30);
  
  $ email = NEU EMAIL(
  
      // Die E-Mail-Adresse, die Sie überprüfen möchten
      'some-email@domain.com',
  
      // und wenn Sie es haben, die IP-Adresse - sonst null oder weggelassen
      '123.123.123.123'
  
  );
  
  VERSUCHEN {
  
      // Überprüfen Sie die E-Mail
      $ ergebnis = $ handler->E-Mail validieren($ email);
  
      OB ($ ergebnis->Status bekommen() === Ergebnis::STATUS_VALID) {
  
          // Alles gut
  
          OB ($ ergebnis->isfreeemail()) {
  
              // Die E-Mail-Adresse ist kostenlos, z. B. @ gmail.com, @ hotmail.com.
  
          }
  
          / ** * Das Benutzerobjekt enthält Metadaten zur von ZeroBounce angegebenen E-Mail-Adresse *. Alle diese Zeichenfolgen können null oder leere * Zeichenfolgen sein. Denken Sie also daran, dies zu überprüfen. * /
          $ user = $ ergebnis->getuser();
  
          $ user->getcountry();
          $ user->getregion();
          $ user->getzipcode();
          $ user->getcity();
          $ user->getgender();
          $ user->getfirstname();
          $ user->getlastname();
  
      } sonst OB ($ ergebnis->Status bekommen() === Ergebnis::STATUS_DO_NOT_MAIL) {
  
          // Der Substatus-Code hilft Ihnen bei der Ermittlung des genauen Problems:
  
          schalter ($ ergebnis->getubstatus()) {
  
              fall Ergebnis::SUBSTATUS_DISPOSABLE:
              fall Ergebnis::SUBSTATUS_TOXIC:
                  // Giftig oder wegwerfbar.
                  unterbrechung;
  
  
              fall Ergebnis::SUBSTATUS_ROLE_BASED:
                  // admin @, helpdesk @, info @ etc; keine persönliche e-mail
                  unterbrechung;
  
              // ... und so weiter.
  
          }
  
      } sonst OB ($ ergebnis->Status bekommen() === Ergebnis::STATUS_INVALID) {
  
          // Ungültige E-Mail.
  
      } sonst OB ($ ergebnis->Status bekommen() === Ergebnis::STATUS_SPAMTRAP) {
  
          // Spamfalle.
  
      } sonst OB ($ ergebnis->Status bekommen() === Ergebnis::STATUS_ABUSE) {
  
          // Missbrauch.
  
      } sonst OB ($ ergebnis->Status bekommen() === Ergebnis::STATUS_CATCH_ALL) {
  
          // Adresse ist Allheilmittel; nicht unbedingt eine private E-Mail.
  
      } sonst OB ($ ergebnis->Status bekommen() === Ergebnis::UNBEKANNTER STATUS) {
  
          // Unbekannter E-Mail-Status.
  
      }
  
      / * * Informationen zur Verwendung und Reaktion auf unterschiedliche Status- und * Untercode-Codes finden Sie in der ZeroBounce-Dokumentation unter: * https://www.zerobounce.net/docs/?swift#version-2__v2__ * /
  
  } Fang (
ickdnkZeroBounceAPIError $ ausnahme) {
  
    // Etwas passiert. Möglicherweise ein schlechter API-Schlüssel oder unzureichendes Guthaben.
  
  }