Skip to main content

Termii Python Library for Termii API

Project description

termiipython

Made in Nigeria Downloads Downloads Downloads

Termii Python Library for Termii API

Installation

pip install termiipython

Usage

from termiipython.token import Token
from termiipython.schemas.token import TokenType

token_client = Token()
token_client.authenticate_from_env()
response = token_client.send_token(
    message_type=TokenType.ALPHANUMERIC,
    receiver="2348152436475",
)
print(response)
from termiipython.messaging import Messaging

messaging_client = Messaging()
messaging_client.authenticate_from_env()

receivers = ["2348152436475", "2347153436435"]
response = messaging_client.send_message(
    receivers=receivers,
    text="Hello all. Thanks for visiting."
)
print(response)
from termiipython.campaign import Campaign

campaign_client = Campaign()
campaign_client.authenticate_from_env()
response = campaign_client.create_phonebook(
    name="Test", description="Test description."
)
print(response)

Authentication.

There are two ways of authenticating requests:

  1. With env variables:

To authenticate with environment variables set TERMII_API_KEY, TERMII_ENDPOINT_URL, TERMII_SENDER_ID to your termii api key, endpoint url and sender ID respectively. Then call client.authenticate_from_env()

Example:

import os

from termiipython.campaign import Campaign

os.environ["TERMII_API_KEY"] = "ukwiwe4642eh"
os.environ["TERMII_ENDPOINT_URL"] = "https://api.ng.termii.com"
os.environ["TERMII_SENDER_ID"] = "Test"

campaign_client = Campaign()
campaign_client.authenticate_from_env()
  1. A second method is to pass in the credentials directly. For that call authenticate_direct() on all clients and pass-in the credentials.

Contributing

Interested in contributing? Check out the contributing guidelines. Please note that this project is released with a Code of Conduct. By contributing to this project, you agree to abide by its terms.

License

termiipython was created by Solomon Olatunji. It is licensed under the terms of the MIT license.

Please send a private mail to lordunyime@gmail.com if you discover any security vulnerability. I'll be happy to work with you on a fix.

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

termiipython-3.1.0.tar.gz (10.7 kB view hashes)

Uploaded Source

Built Distribution

termiipython-3.1.0-py3-none-any.whl (15.0 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page