Skip to content

aglili/arkesel

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

52 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Arkesel Python Package

A Python wrapper for [https://arkesel.com] - an unofficial implementation.

Arkesel Logo

Table of Contents

Installation

you can install the package using Pip

pip install arkesel

Usage

Initialization

from arkesel.smsv1 import SMSV1

sms = SMSV1(api_key="ARKESEL-API-KEY")

look in documentation for full examples

Examples

Example 1-Sending SMS with the V2 api
from arkesel.smsV2 import SMSV2

sms = SMSV2(api_key="ARKESEL-API-KEY")

response = sms.send_sms(sender="Trial",message="Trial Message",recipient=["02xxxxxxy1","0232xxxxxx","050xxxxxxx"])
Expected Response
{
  "status": "success",
  "data": [
    {
      "recipient": "02xxxxxxy1",
      "id": "9b752841-7ee7-4d40-b4fe-768bfb1da4f0"
    },
    {
      "recipient": "0232xxxxxx",
      "id": "7ea01acd-485c-4df3-b646-e9e24430e145"
    },
    {
      "invalid numbers": [
        "050xxxxxxx"
      ]
    }
  ]
}

Example 2-OTP Request
from arkesel.otp import OTP

otp = OTP(api_key="ARKESEL-API-KEY")

response = otp.sms_otp(expiry_minutes=6,recipient="027xxxxxxx",sender_id="Trial")

Expected Response

{
  "code": "1000",
  "ussd_code": "*928*01#",
  "message": "Successful, OTP is being processed for delivery"
}

Check full docs for more help[]

Contributing

Contributing Guidelines

We welcome contributions to improve the project! This guide will help you get started with contributing to our project.

How to Contribute

  1. Fork the repository.

  2. Clone the forked repository to your local machine:

    git clone https://github.com/aglili/arkesel-py.git
  3. Create a new branch for your feature or bugfix

    git checkout -b feature/your-feature   # For a new feature
    git checkout -b bugfix/your-bug-fix    # For a bug fix
  4. Make your changes and commit them

    git add .
    git commit -m "Description of your changes"
  5. Push your branch to GitHub

    git push origin your-branch-name
  6. Open a pull request (PR) to the main repository's main branch. Provide a clear and descriptive title for your PR.

License

This project is licensed under the MIT License. See the LICENSE file for details.

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Contributors 3

  •  
  •  
  •  

Languages