Super easy SDK for Termii SMS APIs.
Install using pip install -U termii-py
.
from termii.token import Token
from termii.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 termii.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 termii.campaign import Campaign
campaign_client = Campaign()
campaign_client.authenticate_from_env()
response = campaign_client.create_phonebook(
name="Test", description="Test description."
)
print(response)
There are two ways of authenticating requests:
- 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 termii.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()
- A second method is to pass in the credentials directly. For that call
authenticate_direct()
on all clients and pass-in the credentials.
For guidance on setting up a development environment and how to make a contribution to termii-py, see Contributing to Termii-py.
Security vulnerabilities are a serious concern. If you discover a potential security issue, please do not create a public issue report. Instead, use the confidential reporting feature provided by GitHub, ensuring the details remain private until a fix is released. You can find instructions on privately reporting vulnerabilities here: Privately reporting a security vulnerability