voipms-python/README.md
2019-08-17 22:02:44 -04:00

39 lines
876 B
Markdown

# voipms-python
A python-based API wrapper for [voip.ms](https://voip.ms/).
## Installation
You can install this package from PyPi using [pip](http://www.pip-installer.org/en/latest/), a package manager for Python. Once pip is installed, run
```sh
pip install --upgrade voipms-python
```
You can also install from source with:
```sh
python setup.py install
```
### Requirements
- Python 2.7+ or 3.4+
## Usage
The library needs to be configured with your account's email and API password, the latter of which can be created [here](https://voip.ms/m/api.php). Set the variables `voipms.email` and `voipms.apikey` to their respective values:
```python
import voipms
voipms.email = "test@email.com"
voipms.api_key = "01N0sWTdiutWTHNF"
# get current account balance
voipms.general.get_balance()
# remove did from account
voipms.dids.cancel_dids(did="5551234567")
```