Python Pingsms API Package

This is a python package for https://pingsms.in API. If you are looking for API usage in PHP click here!

Contents

1. Installation
2. Usage
   1. Importing the package
   2. Input
   3. Methods
   4. Examples
   5. Output
3. Error Codes
4. Get Api Key

Installation

The package is located at PyPI and can be installed with a pip command. To install the package simply run:-

pip install pingsms-api 

Usage

Importing the package

To start using the package first we need to import the package.
Note: Our package name is pingsms-api but from now on we will be using pingsms only for all our tasks.
To import the package run the following command:-

import pingsms

Input

Only one variable of dictionary data type is sent to the methods. A sample dictionary variable is provided for reference:

"""
Sample Variable
"""
custom_data = {
 "key": "AMjdkshmsaZdoV6PGWoSbejmEgFZ905EdmaanahwqkwNVc ",
 "job_id": "021839426237963",
 "report_date":"2021-06-12",
 "product":"1",
 "language":"1",
 "sender":"PNGSMS",
 "mobile":"1232123451",
 "template":"282222382902",
 "message":"Hello World!"
}

There is a total of 9 elements (known as key:value pairs) allowed in the dictionary. Any additional parameters are ignored.

1. key : A user is identified by a unique hashed key. This key can be generated from the https://pingsms.in user panel. All pingsms customers have free access to API keys. This is an mandatory field required by all the methods.
2. job_id : The Job Id number. This parameter is only used in the method get_job_report()
3. report_date : Date Of Report in YYYY-MM-DD Format.This parameter is used in the method get_job_report() and get_sent_sms_reports()
4. product : Choose between two product types
   1 - Transactional
   2 - Promotional
   This parameter is only used in the method send_single_sms() and send_multiple_sms(custom_data)
5. language : Choose between two language formats
   1 - English
   2 - Unicode (Regional Language)
   This parameter is only used in the method send_single_sms() and send_multiple_sms(custom_data)
6. sender : User's approved 6 characters Sender Id.
   This parameter is only used in the method send_single_sms() and send_multiple_sms(custom_data)
7. mobile : 10 digit recipient mobile number. (In case of multiple sms mobile numbers should be provide in comma(,) separated form).
   This parameter is only used in the method send_single_sms() and send_multiple_sms(custom_data)
8. template : Authorised Template number of the user.
   This parameter is only used in the method send_single_sms() and send_multiple_sms(custom_data)
9. message : Authorised message format against the Template number.
   This parameter is only used in the method send_single_sms() and send_multiple_sms(custom_data)

Methods

There are total of 5 available methods:

1. get_sms_balance(custom_data) :
   Get Transactional and Promotional Balance of The User.
   Input Parameter's Required:key
   Output: JSON
2. get_sender_id(custom_data) :
   Get List of Sender Ids of The User.
   Input Parameter's Required:key
   Output: JSON
3. get_job_report(custom_data) :
   Get Job Report of the User.
   Input Parameter's Required:key,job_id,report_date
   Output: JSON
4. get_sent_sms_reports(custom_data) :
   Get SMS sent reports of the User.
   Input Parameter's Required:key,report_date,product
   Output: JSON
5. send_single_sms(custom_data) :
   Send Single SMS.
   Input Parameter's Required:key,sender,mobile,language,product,message, template
   Output: JSON
6. send_multiple_sms(custom_data) :
   Send Multiple SMS.
   Input Parameter's Required:key,sender,mobile(multiple and comma separated),language,product,message,template
   Output: JSON

Examples

"""
Example 1
"""
import pingsms
custom_data = {
"key": "AMjdkshmsaZdoV6PGWoSbejmEgFZ905EdmaanahwqkwNVc ",
}
pingsms.get_sms_balance(custom_data)

"""
Example 2
"""
import pingsms
custom_data = {
"key": "AMjdkshmsaZdoV6PGWoSbejmEgFZ905EdmaanahwqkwNVc ",
"product":"1",
"language":"1",
"sender":"PNGSMS",
"mobile":"1232123451",
"template":"282222382902",
"message":"Hello World!"
}
pingsms.send_multiple_sms(custom_data)

Output

All outputs are returned in the form of JSON.

"""
Example 1 Output
"""
{
    "code": 201,
    "status": "Success",
    "message": "User balance details found",
    "available_balance": {
        "transactional_balance": 9248,
        "promotional_balance": 1029
    }
}

"""
Example 2 Output
"""
{
    "code": 201,
    "status": "Success",
    "message": "Message Sent",
    "job_id": "11312351841231313"
}

Error Codes

Get API Key

     -Sign Up at https://pingsms.in
     -Get API Key from Developer API Tab