Rafikisms Python SDK

HTTP client for the Rafiki SMS vendor API (X-API-Key), aligned with sdk/js and sdk/php.

Developer docs: https://developers.rafikisms.com/

OpenAPI JSON: https://developers.rafikisms.com/v1/docs/openapi.json

Requirements

• Python 3.10+
• httpx

Install (local path)

From another project:

pip install -e ../path/to/rafikisms/sdk/python

Or add to pyproject.toml:

dependencies = [
  "rafikisms-sdk @ file:///${PROJECT_ROOT}/sdk/python",
]

Usage

import os
from rafikisms import Client

with Client("https://api.rafikisms.com", os.environ["RAFIKISMS_API_KEY"]) as c:
    r = c.get_balance()
    if r.success:
        print(r.data["credit_balance"])

OTP

otp = c.generate_otp({"phone_number": "255712345678", "sender_id": "MYBRAND"})
verified = c.verify_otp({
    "phone_number": "255712345678",
    "otp_code": "482916",
    "reference_id": otp.data["reference_id"],
})

Strict errors

from rafikisms import ApiError, Client

c = Client(base_url, api_key, throw_on_error=True)
try:
    c.send_sms({"phone": "255712345678", "message": "Hi"})
except ApiError as e:
    print(e.result.error_code, e.result.errors)

API

Tests

cd sdk/python && pip install -e ".[dev]" && pytest -q

License

MIT.