API Wrappers

//Depending on how you use the API, you might want it to time out faster,//for example on a registration screen. //Normally the API will return results very fast, but a small percentage of//mail servers take upwards of 20+ seconds to respond. //If the API times out, it will return a status of "Unknown" and //a sub_status of "timeout_exceeded" ZeroBounceApizeroBounceApi =newZeroBounceApi("YOUR_API_KEY",TIMEOUT_IN_SECONDS);// Get credits and assign to int variableintcredits =zeroBounceApi.getCredits();// validate email and assign result to a ZeroBounceResponse objectZeroBounceResponsevalidation =zeroBounceApi.validate("some@email.com","some.ip.address can be blank");validation.getEmailAddress();validation.getStatus();validation.isDisposable();validation.getCountry();

varZeroBounceApi=newZeroBounceApi(apiKey)ZeroBounceApi.apiKeyZeroBounceApi.getCredits()ZeroBounceApi.validate("some@email.com","some.ip.address can be blank")

fromzerobounce importZeroBounceAPI zba =ZeroBounceAPI('yourapikey____________')printzba.get_credits()resp1 =zba.validate('flowerjill@aol.com','123.145.124.12')printresp1 {"address":"flowerjill@aol.com","status":"valid","sub_status":"","free_email":True,"did_you_mean":None,"account":"flowerjill","domain":"aol.com","domain_age_days":"8426","smtp_provider":"yahoo","mx_record":"mx-aol.mail.gm0.yahoodns.net","mx_found":"true","firstname":"Jill","lastname":"Stein","gender":"female","country":"United States","region":"Florida","city":"West Palm Beach","zipcode":"33401","processed_at":"2017-04-01 02:48:02.592"}printresp.firstname Jill printresp2.status valid 

<?phprequire_once("zerobounce.php");$zba=newZeroBounceAPI('YOUR_API_KEY');//print the credit balanceprint_r($zba->get_credits());//instantiate a validation object following a call to //validate and print individual elements$validation=$zba->validate('email@address.com','IP can be blank');echo$validation['address'];echo$validation['status'];print_r($zba->validate('email@address.com','IP'));?>

usenickdnkZeroBounceEmail;usenickdnkZeroBounceResult;usenickdnkZeroBounceZeroBounce;// You can modify the timeout using the second parameter. Default is 15.$handler=newZeroBounce('my_api_key',30);$email=newEmail(// The email address you want to check'some-email@domain.com',// and if you have it, the IP address - otherwise null or omitted'123.123.123.123');try{// Validate the email$result=$handler->validateEmail($email);if($result->getStatus()===Result::STATUS_VALID){// All goodif($result->isFreeEmail()){// Email address is free, such as @gmail.com, @hotmail.com.}/** * The user object contains metadata about the email address * supplied by ZeroBounce. All of these may be null or empty * strings, so remember to check for that. */$user=$result->getUser();$user->getCountry();$user->getRegion();$user->getZipCode();$user->getCity();$user->getGender();$user->getFirstName();$user->getLastName();}elseif($result->getStatus()===Result::STATUS_DO_NOT_MAIL){// The substatus code will help you determine the exact issue:switch($result->getSubStatus()){caseResult::SUBSTATUS_DISPOSABLE:caseResult::SUBSTATUS_TOXIC:// Toxic or disposable.break;caseResult::SUBSTATUS_ROLE_BASED:// admin@, helpdesk@, info@ etc; not a personal emailbreak;// ... and so on.}}elseif($result->getStatus()===Result::STATUS_INVALID){// Invalid email.}elseif($result->getStatus()===Result::STATUS_SPAMTRAP){// Spam-trap.}elseif($result->getStatus()===Result::STATUS_ABUSE){// Abuse.}elseif($result->getStatus()===Result::STATUS_CATCH_ALL){// Address is catch-all; not necessarily a private email.}elseif($result->getStatus()===Result::STATUS_UNKNOWN){// Unknown email status.}/* * To find out how to use and react to different status and * substatus codes, see the ZeroBounce documentation at: * https://www.zerobounce.net/docs/?swift#version-2__v2__ */}catch(ickdnkZeroBounceAPIError $exception){// Something happened. Perhaps a bad API key or insufficient credit.}