Blaze Verify Python Library
Blaze Verify is now Emailable! Please switch to using the Emailable client library: https://emailable.com/docs/api?python
This is the official python wrapper for the Blaze Verify API.
Documentation
See the Python API docs.
Installation
pip install blazeverify
Usage
The library needs to be configured with your account's API key which is available in your Blaze Verify Dashboard.
Setup
import blazeverify
client = blazeverify.Client('live_...')
Verification
response = client.verify('evan@blazeverify.com')
response.state
=> 'deliverable'
client.verify('evan@blazeverify.com', smtp=False, accept_all=True, timeout=25)
Slow Email Server Handling
Some email servers are slow to respond. As a result, the timeout may be reached
before we are able to complete the verification process. If this happens, the
verification will continue in the background on our servers. We recommend
sleeping for at least one second and trying your request again. Re-requesting
the same verification with the same options will not impact your credit
allocation within a 5 minute window.
A slow response will return with a 249 status code.
response = client.verify('slow@example.com')
response.status_code
=> 249
response.message
=> 'Your request is taking longer than normal. Please send your request again.'
Batch Verification
Start a batch
emails = ['evan@blazeverify.com', 'support@blazeverify.com', ...]
response = client.batch(emails)
response.id
=> '5cff27400000000000000000'
response = client.batch(emails, callback_url='https://blazeverify.com/')
Get the status / results of a batch
To get the status of a batch call batch_status
with the batch's id. If your batch is still being processed, you will receive a message along with the current progress of the batch. When a batch is completed, you can access the results in the emails
attribute.
response = client.batch_status('5cff27400000000000000000')
response.processed
=> 1
response.total
=> 2
response.message
=> 'Your batch is being processed.'
response.emails
=> [{'email': 'evan@blazeverify.com', 'state': 'deliverable'...}, {'email': 'support@blazeverify.com', 'state': 'deliverable'...}...]
response.total_counts
=>{'deliverable': 2, 'undeliverable': 0 ...}
response.reason_counts
=>{'accepted_email': 2, 'rejected_email': 0 ...}
Development
Tests can be run with the following command:
python setup test
Contributing
Bug reports and pull requests are welcome on GitHub at https://github.com/blazeverify/blazeverify-python.