Skip to main content

REST API library for pushbots.

Project description

A python 2/python 3 REST API library module (wrapper) for pushbots. The module, the tests and the examples work for both python 2 and python 3 versions.
Current “pushbots” module supports all of the pushbots API calls. List of supported API calls follow:
  • Register (For testing API call)
  • Register Batch (For testing API call)
  • unRegister (For testing API call)
  • Alias
  • Tag
  • unTag
  • Device Location (For testing API call)
  • Devices Info
  • Device Info (For testing API call)
  • Push (For testing API call)
  • Push Batch
  • Get Push analytics
  • Record Analytics

In the list above, some of the API calls are tagged with “(For testing API call)”. This means that a token is needed to perform those API calls and since this module is reserved for backends, you, normally, won’t be using those API calls. Though you can retrieve device tokens based on alias, tags, etc through devices info (see examples/ and examples/, examples/ for more info):

There is also a second list of generic API calls, for calls not listed in the first list. At the moment of creating this all API calls are supported. This is provided for future API calls:

  • Put (For generic put API calls, not listed above)
  • Post (For generic post API calls, not listed above)
  • Get (For generic get API calls, not listed above)


You can choose to install “pushbots”. If you don’t want to install it, you can manually copy the “pushbots” package into your project. There are two ways to install “pushbots”.

  • With pip: pip install pushbots
  • Manually: Go to releases and download the latest version. Extract the compressed file, navigate to project’s root directory and run: python install


For “pushbots” to work, python “requests” must be installed. If you already have “setuptools” installed and choose to install “pushbots” from pip or, you don’t have to manually install “requests”. On any other case, you must install it manually:
pip install requests

How to use

from pushbots import Pushbots
# Your code


You can find examples under pushbots/examples directory. If there is an API call missing from the first list mentioned above, you can view the examples/ examples, on how to make custom API calls, listed in the second list mentioned (put, post, get). If you want to perform token operations, you can use the examples/ to get the devices tokens and platforms associated with a specific alias. Also the files, examples/ and examples/ make use of tokens to make an API call, whereas all the other files in examples make use of alias, tags etc for the API calls.


The tests package is located under pushbots directory. Tests create virtual devices to test the API calls provided by “pushbots” module. You can run the tests by typing:

python -m

If you want help on how to run tests, type:

python -m -h

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pushbots-0.0.1.tar.gz (13.5 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page