| Name | voipms-api JSON |
| Version |
1.1.5b11
JSON |
| download |
| home_page | None |
| Summary | A python package to simplify the use of the VoIP.ms API |
| upload_time | 2024-09-11 00:48:30 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.10 |
| license | None |
| keywords |
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# voipms-api
This package is developed to streamline the process of integrating with the VoIP.ms API, allowing developers to focus on implementing functionality without the need to write boilerplate code for API connectivity and function calls. The VoIP.ms API Client encapsulates all necessary code to connect and interact with the VoIP.ms API, enabling developers to call functions directly.
## Features
- **Simplified Integration**: Connect to the VoIP.ms API with minimal setup.
- **Modular Design**: Organized into separate modules for different functionalities, allowing targeted imports and reduced overhead.
- **Ongoing Development**: New functions will continue to be added.
## Updates
- \*\*1.1.5b11:
- DIDs
- Added method 'set_did_routing'.
- \*\*1.1.4b11:
- Accounts
- Methods updated: 'create_sub_account', 'update_subaccount'
- added additional validations for the username on 'create_sub_account'.
- arg 'extension' renamed to 'internal_extension'.
- added optional arg 'internal_voicemail'.
- added optional arg 'internal_cnam' to specify a Caller ID name for internal calls.
- added optional arg 'enable_internal_cnam' to enable/disable the internal Caller ID name.
- \*\*1.1.3b11:
- Fixed bug on 'create_call_hunting' and 'update_call_hunting' that did not allow adding multiple members.
- \*\*1.1.2b11:
- Accounts
- Method updated: 'create_sub_account'
- arg 'password' set as optional so Sub Accounts can be created using IP authentication.
- added optional arg 'ip' for sub accounts created with 'auth_type' IP authentication.
- added optional arg 'codecs' to specify the codec the sub account will use.
- added optional arg 'lock_international' to enable/disable International calls.
- added optional arg 'callerid_number' to set a caller ID number for the sub account.
- Added method 'update_subaccounts'
- CallHunting
- Added method 'update_call_hunting'
- Forwarding
- Added method 'update_forwarding'
- General
- Bug fixed on 'get_transactions' that did not allow get records from one single day.
- IVR
- Added method 'update_ivr'
- RingGroup
- Method updated: 'create_ring_group'
- added optional arg 'announcement' to set an announcement recording.
- added optional arg 'music_on_hold' to set music on hold.
- added optional arg 'language' to set the language.
- Added method 'update_ring_group'
- SMS
- Added method 'get_sms'
- Voicemail
- Added method 'update_voicemail'
- \*\*1.0.2b11: The method create_sub_account now accepts description as an optional argument.
- \*\*1.0.1b11: Fixed bug that causes importing errors when using the module Voicemail.
- \*\*1.0.0b11: All modules were refactored to improve imports.
## Installation
The package is now available at PyPi and can be installed in your virtual environment running this command:
```
pip install voipms-api
```
You can also clone the repository in your project from [Github](https://github.com/joseanmont/voipms-api).
**Note:** If you clone it and have problems importing the modules, add the path to the directory and subdirectories in PYTHONPATH.
## Package structure
```plaintext
voipms-api
├── src/
│ └── voipms_api/
│ ├── __init__.py
│ ├── accounts.py
│ ├── call_hunting.py
│ ├── dids.py
│ ├── forwarding.py
│ ├── general.py
│ ├── ivr.py
│ ├── lnp.py
│ ├── ring_groups.py
│ ├── sms.py
│ ├── voicemail.py
│ └── voipms_client.py
│── tests/
│ └── test_voipms_client.py
```
## Usage
The credentials can be loaded on your virtual enviroment by adding the following variables on an .env file:
```.env
VOIPMS_API_USER = "Your VoIP.ms account email"
VOIPMS_API_PASSWORD = "Your VoIP.ms API password"
```
After this, you can start importing the classes and use their functions. Here is an example:
```
from voipms_api import DIDs
dids = DIDs()
print(dids.get_dids_info())
```
Or, you can add the credentials when calling a single instance. For example:
```
from voipms_api import General
balance = General(username="me@email.com", password="api_password")
print(balance.get_balance())
```
Additionally, you can add your credentials or use different credentials by using the class VoipMsClient.
This class also allows you use the method "make_request" to call a VoIP.ms function that might not be available in this package yet.
Here is an example:
```
from voipms_api import VoipMsClient
vms_client = VoipMsClient(username="me@email.com", password="your VoIP.ms API password")
vms_client.make_request("sendFax")
```
## Module Capabilities
Currently, the modules of accounts and voice features within the voipms-api package provide basic functionalities for creating, retrieving, and deleting items.
You will find the current available functions in the description of each class.
Additional functionalities will be added over time.
## Examples of scripts
You can find more examples of scripts in the examples directory in the [Github](https://github.com/joseanmont/voipms-api) repository. These scripts demonstrate how to use the some features of the voipms-api package.
## Contributing
Currently, we are not accepting collaborations. However, if you have suggestions or feedback, feel free to contact us. Issues can be reported on GitHub.
## License
This package is free to use and can be included in any project. See the LICENSE file for more details.
## Support
For any issues or questions, please raise an issue on GitHub or contact us directly at hello@joseanmont.info
## Special Thanks
Kudos to the VoIP.ms development team. They have developed an understandable, simple but still powerful API that lets users take their VoIP system beyond limits.
Raw data
{
"_id": null,
"home_page": null,
"name": "voipms-api",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": null,
"author": null,
"author_email": "Jose Pineda <hello@joseanmont.com>",
"download_url": "https://files.pythonhosted.org/packages/fa/3e/e6f0e72065300f9f791812cd52ebd054f57a8bb599b61d8ca0dc6a33932d/voipms_api-1.1.5b11.tar.gz",
"platform": null,
"description": "# voipms-api\n\nThis package is developed to streamline the process of integrating with the VoIP.ms API, allowing developers to focus on implementing functionality without the need to write boilerplate code for API connectivity and function calls. The VoIP.ms API Client encapsulates all necessary code to connect and interact with the VoIP.ms API, enabling developers to call functions directly.\n\n## Features\n\n- **Simplified Integration**: Connect to the VoIP.ms API with minimal setup.\n- **Modular Design**: Organized into separate modules for different functionalities, allowing targeted imports and reduced overhead.\n- **Ongoing Development**: New functions will continue to be added.\n\n## Updates\n\n- \\*\\*1.1.5b11:\n - DIDs\n - Added method 'set_did_routing'.\n- \\*\\*1.1.4b11:\n - Accounts\n - Methods updated: 'create_sub_account', 'update_subaccount'\n - added additional validations for the username on 'create_sub_account'.\n - arg 'extension' renamed to 'internal_extension'.\n - added optional arg 'internal_voicemail'.\n - added optional arg 'internal_cnam' to specify a Caller ID name for internal calls.\n - added optional arg 'enable_internal_cnam' to enable/disable the internal Caller ID name.\n- \\*\\*1.1.3b11:\n - Fixed bug on 'create_call_hunting' and 'update_call_hunting' that did not allow adding multiple members.\n- \\*\\*1.1.2b11:\n\n - Accounts\n - Method updated: 'create_sub_account'\n - arg 'password' set as optional so Sub Accounts can be created using IP authentication.\n - added optional arg 'ip' for sub accounts created with 'auth_type' IP authentication.\n - added optional arg 'codecs' to specify the codec the sub account will use.\n - added optional arg 'lock_international' to enable/disable International calls.\n - added optional arg 'callerid_number' to set a caller ID number for the sub account.\n - Added method 'update_subaccounts'\n - CallHunting\n - Added method 'update_call_hunting'\n - Forwarding\n - Added method 'update_forwarding'\n - General\n - Bug fixed on 'get_transactions' that did not allow get records from one single day.\n - IVR\n - Added method 'update_ivr'\n - RingGroup\n - Method updated: 'create_ring_group'\n - added optional arg 'announcement' to set an announcement recording.\n - added optional arg 'music_on_hold' to set music on hold.\n - added optional arg 'language' to set the language.\n - Added method 'update_ring_group'\n - SMS\n - Added method 'get_sms'\n - Voicemail\n - Added method 'update_voicemail'\n\n- \\*\\*1.0.2b11: The method create_sub_account now accepts description as an optional argument.\n- \\*\\*1.0.1b11: Fixed bug that causes importing errors when using the module Voicemail.\n- \\*\\*1.0.0b11: All modules were refactored to improve imports.\n\n## Installation\n\nThe package is now available at PyPi and can be installed in your virtual environment running this command:\n\n```\npip install voipms-api\n```\n\nYou can also clone the repository in your project from [Github](https://github.com/joseanmont/voipms-api).\n\n**Note:** If you clone it and have problems importing the modules, add the path to the directory and subdirectories in PYTHONPATH.\n\n## Package structure\n\n```plaintext\nvoipms-api\n\u251c\u2500\u2500 src/\n\u2502 \u2514\u2500\u2500 voipms_api/\n\u2502 \u251c\u2500\u2500 __init__.py\n\u2502 \u251c\u2500\u2500 accounts.py\n\u2502 \u251c\u2500\u2500 call_hunting.py\n\u2502 \u251c\u2500\u2500 dids.py\n\u2502 \u251c\u2500\u2500 forwarding.py\n\u2502 \u251c\u2500\u2500 general.py\n\u2502 \u251c\u2500\u2500 ivr.py\n\u2502 \u251c\u2500\u2500 lnp.py\n\u2502 \u251c\u2500\u2500 ring_groups.py\n\u2502 \u251c\u2500\u2500 sms.py\n\u2502 \u251c\u2500\u2500 voicemail.py\n\u2502 \u2514\u2500\u2500 voipms_client.py\n\u2502\u2500\u2500 tests/\n\u2502 \u2514\u2500\u2500 test_voipms_client.py\n```\n\n## Usage\n\nThe credentials can be loaded on your virtual enviroment by adding the following variables on an .env file:\n\n```.env\nVOIPMS_API_USER = \"Your VoIP.ms account email\"\nVOIPMS_API_PASSWORD = \"Your VoIP.ms API password\"\n```\n\nAfter this, you can start importing the classes and use their functions. Here is an example:\n\n```\nfrom voipms_api import DIDs\n\ndids = DIDs()\nprint(dids.get_dids_info())\n```\n\nOr, you can add the credentials when calling a single instance. For example:\n\n```\nfrom voipms_api import General\n\nbalance = General(username=\"me@email.com\", password=\"api_password\")\nprint(balance.get_balance())\n```\n\nAdditionally, you can add your credentials or use different credentials by using the class VoipMsClient.\n\nThis class also allows you use the method \"make_request\" to call a VoIP.ms function that might not be available in this package yet.\n\nHere is an example:\n\n```\nfrom voipms_api import VoipMsClient\n\nvms_client = VoipMsClient(username=\"me@email.com\", password=\"your VoIP.ms API password\")\nvms_client.make_request(\"sendFax\")\n```\n\n## Module Capabilities\n\nCurrently, the modules of accounts and voice features within the voipms-api package provide basic functionalities for creating, retrieving, and deleting items.\n\nYou will find the current available functions in the description of each class.\n\nAdditional functionalities will be added over time.\n\n## Examples of scripts\n\nYou can find more examples of scripts in the examples directory in the [Github](https://github.com/joseanmont/voipms-api) repository. These scripts demonstrate how to use the some features of the voipms-api package.\n\n## Contributing\n\nCurrently, we are not accepting collaborations. However, if you have suggestions or feedback, feel free to contact us. Issues can be reported on GitHub.\n\n## License\n\nThis package is free to use and can be included in any project. See the LICENSE file for more details.\n\n## Support\n\nFor any issues or questions, please raise an issue on GitHub or contact us directly at hello@joseanmont.info\n\n## Special Thanks\n\nKudos to the VoIP.ms development team. They have developed an understandable, simple but still powerful API that lets users take their VoIP system beyond limits.\n",
"bugtrack_url": null,
"license": null,
"summary": "A python package to simplify the use of the VoIP.ms API",
"version": "1.1.5b11",
"project_urls": {
"Homepage": "https://github.com/joseanmont/voipms-api",
"Issues": "https://github.com/joseanmont/voipms-api/issues"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "965d3f2e7f8927753c1dd15bd4d5101dcbd3bfd3f6d56f4c4a4474a39619b053",
"md5": "8d4721ea1f6cfeb87f35eb8563900370",
"sha256": "4aed11011b8994c645e5bf46abed3e80e30a16f2ee6433da226fde77a5343ce2"
},
"downloads": -1,
"filename": "voipms_api-1.1.5b11-py3-none-any.whl",
"has_sig": false,
"md5_digest": "8d4721ea1f6cfeb87f35eb8563900370",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 25513,
"upload_time": "2024-09-11T00:48:28",
"upload_time_iso_8601": "2024-09-11T00:48:28.546177Z",
"url": "https://files.pythonhosted.org/packages/96/5d/3f2e7f8927753c1dd15bd4d5101dcbd3bfd3f6d56f4c4a4474a39619b053/voipms_api-1.1.5b11-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "fa3ee6f0e72065300f9f791812cd52ebd054f57a8bb599b61d8ca0dc6a33932d",
"md5": "1739422aee89511b83765dac12be57ae",
"sha256": "1d3a62af5dd9e2f832de2600ae68ed5a7d28472df0b556a3812849cad7c87424"
},
"downloads": -1,
"filename": "voipms_api-1.1.5b11.tar.gz",
"has_sig": false,
"md5_digest": "1739422aee89511b83765dac12be57ae",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 19047,
"upload_time": "2024-09-11T00:48:30",
"upload_time_iso_8601": "2024-09-11T00:48:30.222418Z",
"url": "https://files.pythonhosted.org/packages/fa/3e/e6f0e72065300f9f791812cd52ebd054f57a8bb599b61d8ca0dc6a33932d/voipms_api-1.1.5b11.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-09-11 00:48:30",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "joseanmont",
"github_project": "voipms-api",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "voipms-api"
}
