Downloads
Stars
Version
According to kickbox-php:
Kickbox determines if an email address is not only valid, but associated with a actual user. Uses include:
* Preventing users from creating accounts on your applications using fake, misspelled, or throw-away email addresses.
* Reducing bounces by removing old, invalid, and low quality email addresses from your mailing lists.
* Saving money and projecting your reputation by only sending to real email users.
## Getting Started
To begin, hop over to [kickbox.io] and create a free account. Once you've signed up and logged in, click on **API Settings** and then click **Add API Key**. Take note of the generated API Key - you'll need it to setup the client as explained below.
## Bug Reports
Report [here](https://github.com/kickboxio/kickbox-php/issues).
## Need Help?
[email protected]
Add the following to your composer.json
{
"require": {
"samkitano/kbox": "dev-master"
}
}
Update your dependencies
$ php composer.phar update
Open app/config/app.php
, and add a new item to the providers array:
'Samkitano\Kbox\KboxServiceProvider',
Publish your configuration file:
php artisan config:publish samkitano/kbox
Edit app/config/packages/samkitano/kbox/config.php
and provide your API key:
'kickbox_api_key' => 'paste your kickbox api key here',
Works with Laravel [ 4.2 ]
$response = Kbox::verify('[email protected]');
A successful API call responds with the following values:
string
- The verification result: valid
, invalid
, unknown
string
- The reason for the result. Possible reasons are:
invalid_email
- Specified email is not a valid email address syntaxinvalid_domain
- Domain for email does not existrejected_email
- Email address was rejected by the SMTP server, email address does not existaccepted_email
- Email address was accepted by the SMTP serverno_connect
- Could not connect to SMTP servertimeout
- SMTP session timed outinvalid_smtp
- SMTP server returned an unexpected/invalid responseunavailable_smtp
- SMTP server was unavailable to process our requestunexpected_error
- An unexpected error has occurredtrue | false
- true if the email address is a role address ([email protected]
, [email protected]
, etc)true | false
- true if the email address uses a free email service like gmail.com or yahoo.com.true | false
- true if the email address uses a disposable domain like trashmail.com or mailinator.com.true | false
- true if the email was accepted, but the domain appears to accept all emails addressed to that domain.null | string
- Returns a suggested email if a possible spelling error was detected. ([email protected]
-> [email protected]
)float
- A quality score of the provided email address ranging between 0 (no quality) and 1 (perfect quality). More information on the Sendex Score can be found here.string
- Returns a normalized version of the provided email address. ([email protected]
-> [email protected]
string
- The user (a.k.a local part) of the provided email address. ([email protected]
-> bob
)string
- The domain of the provided email address. ([email protected]
-> example.com
)true | false
- true if the API request was successful (i.e., no authentication or unexpected errors occured)MIT