summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--.gitignore1
-rw-r--r--python-zerobouncesdk.spec829
-rw-r--r--sources1
3 files changed, 831 insertions, 0 deletions
diff --git a/.gitignore b/.gitignore
index e69de29..0951d96 100644
--- a/.gitignore
+++ b/.gitignore
@@ -0,0 +1 @@
+/zerobouncesdk-1.0.0.tar.gz
diff --git a/python-zerobouncesdk.spec b/python-zerobouncesdk.spec
new file mode 100644
index 0000000..b3fe2f7
--- /dev/null
+++ b/python-zerobouncesdk.spec
@@ -0,0 +1,829 @@
+%global _empty_manifest_terminate_build 0
+Name: python-zerobouncesdk
+Version: 1.0.0
+Release: 1
+Summary: ZeroBounce Python API - https://www.zerobounce.net.
+License: MIT License
+URL: https://github.com/zerobounce/zero-bounce-python-sdk-setup
+Source0: https://mirrors.nju.edu.cn/pypi/web/packages/f8/1f/6d08915ba78e799b53e66ec40303be27519807329c2023ae15a29840bd74/zerobouncesdk-1.0.0.tar.gz
+BuildArch: noarch
+
+Requires: python3-requests
+
+%description
+## Zero Bounce Python SDK
+This SDK contains methods for interacting easily with ZeroBounce API.
+More information about ZeroBounce you can find in the [official documentation](https://www.zerobounce.net/docs/).
+
+## INSTALLATION
+```bash
+pip install zerobouncesdk
+```
+
+## USAGE
+Import the sdk in your file:
+
+```python
+from zerobouncesdk import ZeroBounce
+```
+
+Initialize the sdk with your api key:
+
+```python
+zero_bounce = ZeroBounce("<YOUR_API_KEY>")
+```
+
+## Examples
+Then you can use any of the SDK methods, for example:
+
+* ##### Check how many credits you have left on your account
+```python
+from zerobouncesdk import ZeroBounce
+
+zero_bounce = ZeroBounce("<YOUR_API_KEY>")
+
+response = zero_bounce.get_credits()
+print("ZeroBounce get_credits response: " + response)
+```
+
+* ##### Check your API usage for a given period of time
+```python
+from datetime import datetime
+from zerobouncesdk import ZeroBounce, ZBException
+
+zero_bounce = ZeroBounce("<YOUR_API_KEY>")
+
+start_date = datetime(2019, 8, 1); // The start date of when you want to view API usage
+end_date = datetime(2019, 9, 1); // The end date of when you want to view API usage
+
+try:
+ response = zero_bounce.get_api_usage(start_date, end_date)
+ print("ZeroBounce get_api_usage response: " + response)
+except ZBException as e:
+ print("ZeroBounce get_api_usage error: " + str(e))
+```
+
+* ##### Gather insights into your subscribers' overall email engagement
+```python
+from zerobouncesdk import ZeroBounce, ZBException
+
+zero_bounce = ZeroBounce("<YOUR_API_KEY>")
+
+email = "valid@example.com"; // Subscriber email address
+
+try:
+ response = zero_bounce.get_activity(email)
+ print("ZeroBounce get_activity response: " + response)
+except ZBException as e:
+ print("ZeroBounce get_activity error: " + str(e))
+```
+
+* ##### Validate an email address
+```python
+from zerobouncesdk import ZeroBounce, ZBException
+
+zero_bounce = ZeroBounce("<YOUR_API_KEY>")
+
+email = "<EMAIL_ADDRESS>" // The email address you want to validate
+ip_address = "127.0.0.1" // The IP Address the email signed up from (Optional)
+
+try:
+ response = zero_bounce.validate(email, ip_address)
+ print("ZeroBounce validate response: " + response)
+except ZBException as e:
+ print("ZeroBounce validate error: " + str(e))
+```
+
+* ##### Validate a batch of up to 100 emails at a time
+```python
+from zerobouncesdk import ZeroBounce, ZBException, ZBValidateBatchElement
+
+zero_bounce = ZeroBounce("<YOUR_API_KEY>")
+
+email_batch = [
+ ZBValidateBatchElement("valid@example.com", "127.0.0.1"),
+ ZBValidateBatchElement("invalid@example.com"),
+] // The batch of emails you want to validate
+
+try:
+ response = zero_bounce.validate_batch(email_batch)
+ print("ZeroBounce validate_batch response: " + response)
+except ZBException as e:
+ print("ZeroBounce validate_batch error: " + str(e))
+```
+
+* ##### The _sendFile_ API allows user to send a file for bulk email validation
+```python
+from zerobouncesdk import ZeroBounce, ZBException
+
+zero_bounce = ZeroBounce("<YOUR_API_KEY>")
+
+file_path = './email_file.csv' // The csv or txt file
+email_address_column = 1 // The index of "email" column in the file. Index starts at 1
+return_url = "https://domain.com/called/after/processing/request"
+first_name_column = None // The index of "first name" column in the file
+last_name_column = None // The index of "last name" column in the file
+gender_column = None // The index of "gender" column in the file
+ip_address_column = None // The index of "IP address" column in the file
+has_header_row = False // If the first row from the submitted file is a header row
+remove_duplicate = True // If you want the system to remove duplicate emails
+
+try:
+ response = zero_bounce.send_file(
+ file_path,
+ email_address_column,
+ return_url,
+ first_name_column,
+ last_name_column,
+ gender_column,
+ ip_address_column,
+ has_header_row,
+ remove_duplicate,
+ )
+ print("ZeroBounce send_file response: " + response)
+except ZBException as e:
+ print("ZeroBounce send_file error: " + str(e))
+```
+
+* ##### Check the status of a file uploaded via _sendFile_ method
+```python
+from zerobouncesdk import ZeroBounce, ZBException
+
+zero_bounce = ZeroBounce("<YOUR_API_KEY>")
+
+file_id = "<FILE_ID>" // The returned file ID when calling sendFile API
+
+try:
+ response = zero_bounce.file_status(file_id)
+ print("ZeroBounce file_status response: " + response)
+except ZBException as e:
+ print("ZeroBounce file_status error: " + str(e))
+```
+
+* ##### The _getfile_ API allows users to get the validation results file for the file been submitted using _sendFile_ API
+```python
+from zerobouncesdk import ZeroBounce, ZBException
+
+zero_bounce = ZeroBounce("<YOUR_API_KEY>")
+
+file_id="<FILE_ID>" // The returned file ID when calling sendFile API
+local_download_path = "./dwnld_file.csv" // The path where the file will be downloaded
+
+try:
+ response = zero_bounce.get_file(file_id, local_download_path)
+ print("ZeroBounce get_file response: " + response)
+except ZBException as e:
+ print("ZeroBounce get_file error: " + str(e))
+```
+
+* ##### Delete the file that was submitted using _sendFile_ API. File can be deleted only when its status is `Complete`
+```python
+from zerobouncesdk import ZeroBounce, ZBException
+
+zero_bounce = ZeroBounce("<YOUR_API_KEY>")
+
+file_id="<FILE_ID>" // The returned file ID when calling sendFile API
+
+try:
+ response = zero_bounce.delete_file(file_id)
+ print("ZeroBounce delete_file response: " + response)
+except ZBException as e:
+ print("ZeroBounce delete_file error: " + str(e))
+```
+
+### AI Scoring API
+
+* ##### The _scoringSendFile_ API allows user to send a file for bulk email scoring
+```python
+from zerobouncesdk import ZeroBounce, ZBException
+
+zero_bounce = ZeroBounce("<YOUR_API_KEY>")
+
+file_path = './email_file.csv' // The csv or txt file
+email_address_column = 1 // The index of "email" column in the file. Index starts at 1
+return_url = "https://domain.com/called/after/processing/request"
+has_header_row = False // If the first row from the submitted file is a header row
+remove_duplicate = True // If you want the system to remove duplicate emails
+
+try:
+ response = zero_bounce.scoring_send_file(
+ file_path,
+ email_address_column,
+ return_url,
+ has_header_row,
+ remove_duplicate,
+ )
+ print("ZeroBounce send_file response: " + response)
+except ZBException as e:
+ print("ZeroBounce send_file error: " + str(e))
+```
+
+* ##### Check the status of a file uploaded via _scoringSendFile_ method
+```python
+from zerobouncesdk import ZeroBounce, ZBException
+
+zero_bounce = ZeroBounce("<YOUR_API_KEY>")
+
+file_id = "<FILE_ID>" // The returned file ID when calling scoringSendFile API
+
+try:
+ response = zero_bounce.scoring_file_status(file_id)
+ print("ZeroBounce file_status response: " + response)
+except ZBException as e:
+ print("ZeroBounce file_status error: " + str(e))
+```
+
+* ##### The scoring _scoringGetFile_ API allows users to get the validation results file for the file been submitted using scoring _scoringSendFile_ API
+```python
+from zerobouncesdk import ZeroBounce, ZBException
+
+zero_bounce = ZeroBounce("<YOUR_API_KEY>")
+
+file_id="<FILE_ID>" // The returned file ID when calling scoringSendFile API
+local_download_path = "./dwnld_file.csv" // The path where the file will be downloaded
+
+try:
+ response = zero_bounce.scoring_get_file(file_id, local_download_path)
+ print("ZeroBounce get_file response: " + response)
+except ZBException as e:
+ print("ZeroBounce get_file error: " + str(e))
+```
+
+* ##### Delete the file that was submitted using _scoringSendFile_ API. File can be deleted only when its status is `Complete`
+```python
+from zerobouncesdk import ZeroBounce, ZBException
+
+zero_bounce = ZeroBounce("<YOUR_API_KEY>")
+
+file_id="<FILE_ID>" // The returned file ID when calling scoringSendFile API
+
+try:
+ response = zero_bounce.scoring_delete_file(file_id)
+ print("ZeroBounce delete_file response: " + response)
+except ZBException as e:
+ print("ZeroBounce delete_file error: " + str(e))
+```
+
+
+%package -n python3-zerobouncesdk
+Summary: ZeroBounce Python API - https://www.zerobounce.net.
+Provides: python-zerobouncesdk
+BuildRequires: python3-devel
+BuildRequires: python3-setuptools
+BuildRequires: python3-pip
+%description -n python3-zerobouncesdk
+## Zero Bounce Python SDK
+This SDK contains methods for interacting easily with ZeroBounce API.
+More information about ZeroBounce you can find in the [official documentation](https://www.zerobounce.net/docs/).
+
+## INSTALLATION
+```bash
+pip install zerobouncesdk
+```
+
+## USAGE
+Import the sdk in your file:
+
+```python
+from zerobouncesdk import ZeroBounce
+```
+
+Initialize the sdk with your api key:
+
+```python
+zero_bounce = ZeroBounce("<YOUR_API_KEY>")
+```
+
+## Examples
+Then you can use any of the SDK methods, for example:
+
+* ##### Check how many credits you have left on your account
+```python
+from zerobouncesdk import ZeroBounce
+
+zero_bounce = ZeroBounce("<YOUR_API_KEY>")
+
+response = zero_bounce.get_credits()
+print("ZeroBounce get_credits response: " + response)
+```
+
+* ##### Check your API usage for a given period of time
+```python
+from datetime import datetime
+from zerobouncesdk import ZeroBounce, ZBException
+
+zero_bounce = ZeroBounce("<YOUR_API_KEY>")
+
+start_date = datetime(2019, 8, 1); // The start date of when you want to view API usage
+end_date = datetime(2019, 9, 1); // The end date of when you want to view API usage
+
+try:
+ response = zero_bounce.get_api_usage(start_date, end_date)
+ print("ZeroBounce get_api_usage response: " + response)
+except ZBException as e:
+ print("ZeroBounce get_api_usage error: " + str(e))
+```
+
+* ##### Gather insights into your subscribers' overall email engagement
+```python
+from zerobouncesdk import ZeroBounce, ZBException
+
+zero_bounce = ZeroBounce("<YOUR_API_KEY>")
+
+email = "valid@example.com"; // Subscriber email address
+
+try:
+ response = zero_bounce.get_activity(email)
+ print("ZeroBounce get_activity response: " + response)
+except ZBException as e:
+ print("ZeroBounce get_activity error: " + str(e))
+```
+
+* ##### Validate an email address
+```python
+from zerobouncesdk import ZeroBounce, ZBException
+
+zero_bounce = ZeroBounce("<YOUR_API_KEY>")
+
+email = "<EMAIL_ADDRESS>" // The email address you want to validate
+ip_address = "127.0.0.1" // The IP Address the email signed up from (Optional)
+
+try:
+ response = zero_bounce.validate(email, ip_address)
+ print("ZeroBounce validate response: " + response)
+except ZBException as e:
+ print("ZeroBounce validate error: " + str(e))
+```
+
+* ##### Validate a batch of up to 100 emails at a time
+```python
+from zerobouncesdk import ZeroBounce, ZBException, ZBValidateBatchElement
+
+zero_bounce = ZeroBounce("<YOUR_API_KEY>")
+
+email_batch = [
+ ZBValidateBatchElement("valid@example.com", "127.0.0.1"),
+ ZBValidateBatchElement("invalid@example.com"),
+] // The batch of emails you want to validate
+
+try:
+ response = zero_bounce.validate_batch(email_batch)
+ print("ZeroBounce validate_batch response: " + response)
+except ZBException as e:
+ print("ZeroBounce validate_batch error: " + str(e))
+```
+
+* ##### The _sendFile_ API allows user to send a file for bulk email validation
+```python
+from zerobouncesdk import ZeroBounce, ZBException
+
+zero_bounce = ZeroBounce("<YOUR_API_KEY>")
+
+file_path = './email_file.csv' // The csv or txt file
+email_address_column = 1 // The index of "email" column in the file. Index starts at 1
+return_url = "https://domain.com/called/after/processing/request"
+first_name_column = None // The index of "first name" column in the file
+last_name_column = None // The index of "last name" column in the file
+gender_column = None // The index of "gender" column in the file
+ip_address_column = None // The index of "IP address" column in the file
+has_header_row = False // If the first row from the submitted file is a header row
+remove_duplicate = True // If you want the system to remove duplicate emails
+
+try:
+ response = zero_bounce.send_file(
+ file_path,
+ email_address_column,
+ return_url,
+ first_name_column,
+ last_name_column,
+ gender_column,
+ ip_address_column,
+ has_header_row,
+ remove_duplicate,
+ )
+ print("ZeroBounce send_file response: " + response)
+except ZBException as e:
+ print("ZeroBounce send_file error: " + str(e))
+```
+
+* ##### Check the status of a file uploaded via _sendFile_ method
+```python
+from zerobouncesdk import ZeroBounce, ZBException
+
+zero_bounce = ZeroBounce("<YOUR_API_KEY>")
+
+file_id = "<FILE_ID>" // The returned file ID when calling sendFile API
+
+try:
+ response = zero_bounce.file_status(file_id)
+ print("ZeroBounce file_status response: " + response)
+except ZBException as e:
+ print("ZeroBounce file_status error: " + str(e))
+```
+
+* ##### The _getfile_ API allows users to get the validation results file for the file been submitted using _sendFile_ API
+```python
+from zerobouncesdk import ZeroBounce, ZBException
+
+zero_bounce = ZeroBounce("<YOUR_API_KEY>")
+
+file_id="<FILE_ID>" // The returned file ID when calling sendFile API
+local_download_path = "./dwnld_file.csv" // The path where the file will be downloaded
+
+try:
+ response = zero_bounce.get_file(file_id, local_download_path)
+ print("ZeroBounce get_file response: " + response)
+except ZBException as e:
+ print("ZeroBounce get_file error: " + str(e))
+```
+
+* ##### Delete the file that was submitted using _sendFile_ API. File can be deleted only when its status is `Complete`
+```python
+from zerobouncesdk import ZeroBounce, ZBException
+
+zero_bounce = ZeroBounce("<YOUR_API_KEY>")
+
+file_id="<FILE_ID>" // The returned file ID when calling sendFile API
+
+try:
+ response = zero_bounce.delete_file(file_id)
+ print("ZeroBounce delete_file response: " + response)
+except ZBException as e:
+ print("ZeroBounce delete_file error: " + str(e))
+```
+
+### AI Scoring API
+
+* ##### The _scoringSendFile_ API allows user to send a file for bulk email scoring
+```python
+from zerobouncesdk import ZeroBounce, ZBException
+
+zero_bounce = ZeroBounce("<YOUR_API_KEY>")
+
+file_path = './email_file.csv' // The csv or txt file
+email_address_column = 1 // The index of "email" column in the file. Index starts at 1
+return_url = "https://domain.com/called/after/processing/request"
+has_header_row = False // If the first row from the submitted file is a header row
+remove_duplicate = True // If you want the system to remove duplicate emails
+
+try:
+ response = zero_bounce.scoring_send_file(
+ file_path,
+ email_address_column,
+ return_url,
+ has_header_row,
+ remove_duplicate,
+ )
+ print("ZeroBounce send_file response: " + response)
+except ZBException as e:
+ print("ZeroBounce send_file error: " + str(e))
+```
+
+* ##### Check the status of a file uploaded via _scoringSendFile_ method
+```python
+from zerobouncesdk import ZeroBounce, ZBException
+
+zero_bounce = ZeroBounce("<YOUR_API_KEY>")
+
+file_id = "<FILE_ID>" // The returned file ID when calling scoringSendFile API
+
+try:
+ response = zero_bounce.scoring_file_status(file_id)
+ print("ZeroBounce file_status response: " + response)
+except ZBException as e:
+ print("ZeroBounce file_status error: " + str(e))
+```
+
+* ##### The scoring _scoringGetFile_ API allows users to get the validation results file for the file been submitted using scoring _scoringSendFile_ API
+```python
+from zerobouncesdk import ZeroBounce, ZBException
+
+zero_bounce = ZeroBounce("<YOUR_API_KEY>")
+
+file_id="<FILE_ID>" // The returned file ID when calling scoringSendFile API
+local_download_path = "./dwnld_file.csv" // The path where the file will be downloaded
+
+try:
+ response = zero_bounce.scoring_get_file(file_id, local_download_path)
+ print("ZeroBounce get_file response: " + response)
+except ZBException as e:
+ print("ZeroBounce get_file error: " + str(e))
+```
+
+* ##### Delete the file that was submitted using _scoringSendFile_ API. File can be deleted only when its status is `Complete`
+```python
+from zerobouncesdk import ZeroBounce, ZBException
+
+zero_bounce = ZeroBounce("<YOUR_API_KEY>")
+
+file_id="<FILE_ID>" // The returned file ID when calling scoringSendFile API
+
+try:
+ response = zero_bounce.scoring_delete_file(file_id)
+ print("ZeroBounce delete_file response: " + response)
+except ZBException as e:
+ print("ZeroBounce delete_file error: " + str(e))
+```
+
+
+%package help
+Summary: Development documents and examples for zerobouncesdk
+Provides: python3-zerobouncesdk-doc
+%description help
+## Zero Bounce Python SDK
+This SDK contains methods for interacting easily with ZeroBounce API.
+More information about ZeroBounce you can find in the [official documentation](https://www.zerobounce.net/docs/).
+
+## INSTALLATION
+```bash
+pip install zerobouncesdk
+```
+
+## USAGE
+Import the sdk in your file:
+
+```python
+from zerobouncesdk import ZeroBounce
+```
+
+Initialize the sdk with your api key:
+
+```python
+zero_bounce = ZeroBounce("<YOUR_API_KEY>")
+```
+
+## Examples
+Then you can use any of the SDK methods, for example:
+
+* ##### Check how many credits you have left on your account
+```python
+from zerobouncesdk import ZeroBounce
+
+zero_bounce = ZeroBounce("<YOUR_API_KEY>")
+
+response = zero_bounce.get_credits()
+print("ZeroBounce get_credits response: " + response)
+```
+
+* ##### Check your API usage for a given period of time
+```python
+from datetime import datetime
+from zerobouncesdk import ZeroBounce, ZBException
+
+zero_bounce = ZeroBounce("<YOUR_API_KEY>")
+
+start_date = datetime(2019, 8, 1); // The start date of when you want to view API usage
+end_date = datetime(2019, 9, 1); // The end date of when you want to view API usage
+
+try:
+ response = zero_bounce.get_api_usage(start_date, end_date)
+ print("ZeroBounce get_api_usage response: " + response)
+except ZBException as e:
+ print("ZeroBounce get_api_usage error: " + str(e))
+```
+
+* ##### Gather insights into your subscribers' overall email engagement
+```python
+from zerobouncesdk import ZeroBounce, ZBException
+
+zero_bounce = ZeroBounce("<YOUR_API_KEY>")
+
+email = "valid@example.com"; // Subscriber email address
+
+try:
+ response = zero_bounce.get_activity(email)
+ print("ZeroBounce get_activity response: " + response)
+except ZBException as e:
+ print("ZeroBounce get_activity error: " + str(e))
+```
+
+* ##### Validate an email address
+```python
+from zerobouncesdk import ZeroBounce, ZBException
+
+zero_bounce = ZeroBounce("<YOUR_API_KEY>")
+
+email = "<EMAIL_ADDRESS>" // The email address you want to validate
+ip_address = "127.0.0.1" // The IP Address the email signed up from (Optional)
+
+try:
+ response = zero_bounce.validate(email, ip_address)
+ print("ZeroBounce validate response: " + response)
+except ZBException as e:
+ print("ZeroBounce validate error: " + str(e))
+```
+
+* ##### Validate a batch of up to 100 emails at a time
+```python
+from zerobouncesdk import ZeroBounce, ZBException, ZBValidateBatchElement
+
+zero_bounce = ZeroBounce("<YOUR_API_KEY>")
+
+email_batch = [
+ ZBValidateBatchElement("valid@example.com", "127.0.0.1"),
+ ZBValidateBatchElement("invalid@example.com"),
+] // The batch of emails you want to validate
+
+try:
+ response = zero_bounce.validate_batch(email_batch)
+ print("ZeroBounce validate_batch response: " + response)
+except ZBException as e:
+ print("ZeroBounce validate_batch error: " + str(e))
+```
+
+* ##### The _sendFile_ API allows user to send a file for bulk email validation
+```python
+from zerobouncesdk import ZeroBounce, ZBException
+
+zero_bounce = ZeroBounce("<YOUR_API_KEY>")
+
+file_path = './email_file.csv' // The csv or txt file
+email_address_column = 1 // The index of "email" column in the file. Index starts at 1
+return_url = "https://domain.com/called/after/processing/request"
+first_name_column = None // The index of "first name" column in the file
+last_name_column = None // The index of "last name" column in the file
+gender_column = None // The index of "gender" column in the file
+ip_address_column = None // The index of "IP address" column in the file
+has_header_row = False // If the first row from the submitted file is a header row
+remove_duplicate = True // If you want the system to remove duplicate emails
+
+try:
+ response = zero_bounce.send_file(
+ file_path,
+ email_address_column,
+ return_url,
+ first_name_column,
+ last_name_column,
+ gender_column,
+ ip_address_column,
+ has_header_row,
+ remove_duplicate,
+ )
+ print("ZeroBounce send_file response: " + response)
+except ZBException as e:
+ print("ZeroBounce send_file error: " + str(e))
+```
+
+* ##### Check the status of a file uploaded via _sendFile_ method
+```python
+from zerobouncesdk import ZeroBounce, ZBException
+
+zero_bounce = ZeroBounce("<YOUR_API_KEY>")
+
+file_id = "<FILE_ID>" // The returned file ID when calling sendFile API
+
+try:
+ response = zero_bounce.file_status(file_id)
+ print("ZeroBounce file_status response: " + response)
+except ZBException as e:
+ print("ZeroBounce file_status error: " + str(e))
+```
+
+* ##### The _getfile_ API allows users to get the validation results file for the file been submitted using _sendFile_ API
+```python
+from zerobouncesdk import ZeroBounce, ZBException
+
+zero_bounce = ZeroBounce("<YOUR_API_KEY>")
+
+file_id="<FILE_ID>" // The returned file ID when calling sendFile API
+local_download_path = "./dwnld_file.csv" // The path where the file will be downloaded
+
+try:
+ response = zero_bounce.get_file(file_id, local_download_path)
+ print("ZeroBounce get_file response: " + response)
+except ZBException as e:
+ print("ZeroBounce get_file error: " + str(e))
+```
+
+* ##### Delete the file that was submitted using _sendFile_ API. File can be deleted only when its status is `Complete`
+```python
+from zerobouncesdk import ZeroBounce, ZBException
+
+zero_bounce = ZeroBounce("<YOUR_API_KEY>")
+
+file_id="<FILE_ID>" // The returned file ID when calling sendFile API
+
+try:
+ response = zero_bounce.delete_file(file_id)
+ print("ZeroBounce delete_file response: " + response)
+except ZBException as e:
+ print("ZeroBounce delete_file error: " + str(e))
+```
+
+### AI Scoring API
+
+* ##### The _scoringSendFile_ API allows user to send a file for bulk email scoring
+```python
+from zerobouncesdk import ZeroBounce, ZBException
+
+zero_bounce = ZeroBounce("<YOUR_API_KEY>")
+
+file_path = './email_file.csv' // The csv or txt file
+email_address_column = 1 // The index of "email" column in the file. Index starts at 1
+return_url = "https://domain.com/called/after/processing/request"
+has_header_row = False // If the first row from the submitted file is a header row
+remove_duplicate = True // If you want the system to remove duplicate emails
+
+try:
+ response = zero_bounce.scoring_send_file(
+ file_path,
+ email_address_column,
+ return_url,
+ has_header_row,
+ remove_duplicate,
+ )
+ print("ZeroBounce send_file response: " + response)
+except ZBException as e:
+ print("ZeroBounce send_file error: " + str(e))
+```
+
+* ##### Check the status of a file uploaded via _scoringSendFile_ method
+```python
+from zerobouncesdk import ZeroBounce, ZBException
+
+zero_bounce = ZeroBounce("<YOUR_API_KEY>")
+
+file_id = "<FILE_ID>" // The returned file ID when calling scoringSendFile API
+
+try:
+ response = zero_bounce.scoring_file_status(file_id)
+ print("ZeroBounce file_status response: " + response)
+except ZBException as e:
+ print("ZeroBounce file_status error: " + str(e))
+```
+
+* ##### The scoring _scoringGetFile_ API allows users to get the validation results file for the file been submitted using scoring _scoringSendFile_ API
+```python
+from zerobouncesdk import ZeroBounce, ZBException
+
+zero_bounce = ZeroBounce("<YOUR_API_KEY>")
+
+file_id="<FILE_ID>" // The returned file ID when calling scoringSendFile API
+local_download_path = "./dwnld_file.csv" // The path where the file will be downloaded
+
+try:
+ response = zero_bounce.scoring_get_file(file_id, local_download_path)
+ print("ZeroBounce get_file response: " + response)
+except ZBException as e:
+ print("ZeroBounce get_file error: " + str(e))
+```
+
+* ##### Delete the file that was submitted using _scoringSendFile_ API. File can be deleted only when its status is `Complete`
+```python
+from zerobouncesdk import ZeroBounce, ZBException
+
+zero_bounce = ZeroBounce("<YOUR_API_KEY>")
+
+file_id="<FILE_ID>" // The returned file ID when calling scoringSendFile API
+
+try:
+ response = zero_bounce.scoring_delete_file(file_id)
+ print("ZeroBounce delete_file response: " + response)
+except ZBException as e:
+ print("ZeroBounce delete_file error: " + str(e))
+```
+
+
+%prep
+%autosetup -n zerobouncesdk-1.0.0
+
+%build
+%py3_build
+
+%install
+%py3_install
+install -d -m755 %{buildroot}/%{_pkgdocdir}
+if [ -d doc ]; then cp -arf doc %{buildroot}/%{_pkgdocdir}; fi
+if [ -d docs ]; then cp -arf docs %{buildroot}/%{_pkgdocdir}; fi
+if [ -d example ]; then cp -arf example %{buildroot}/%{_pkgdocdir}; fi
+if [ -d examples ]; then cp -arf examples %{buildroot}/%{_pkgdocdir}; fi
+pushd %{buildroot}
+if [ -d usr/lib ]; then
+ find usr/lib -type f -printf "/%h/%f\n" >> filelist.lst
+fi
+if [ -d usr/lib64 ]; then
+ find usr/lib64 -type f -printf "/%h/%f\n" >> filelist.lst
+fi
+if [ -d usr/bin ]; then
+ find usr/bin -type f -printf "/%h/%f\n" >> filelist.lst
+fi
+if [ -d usr/sbin ]; then
+ find usr/sbin -type f -printf "/%h/%f\n" >> filelist.lst
+fi
+touch doclist.lst
+if [ -d usr/share/man ]; then
+ find usr/share/man -type f -printf "/%h/%f.gz\n" >> doclist.lst
+fi
+popd
+mv %{buildroot}/filelist.lst .
+mv %{buildroot}/doclist.lst .
+
+%files -n python3-zerobouncesdk -f filelist.lst
+%dir %{python3_sitelib}/*
+
+%files help -f doclist.lst
+%{_docdir}/*
+
+%changelog
+* Wed Apr 12 2023 Python_Bot <Python_Bot@openeuler.org> - 1.0.0-1
+- Package Spec generated
diff --git a/sources b/sources
new file mode 100644
index 0000000..c4de464
--- /dev/null
+++ b/sources
@@ -0,0 +1 @@
+a11e4e1817090ef64b66969c5ac6feeb zerobouncesdk-1.0.0.tar.gz