GitLocker: The Coding Marketplace

Description:

pingsmsapi 1.0.3

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

Installation
Usage

Importing the package
Input
Methods
Examples
Output

Error Codes
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.

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.
job_id : The Job Id number. This parameter is only used in the method get_job_report()
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()
product : Choose between two product types 1 - Transactional2 - Promotional This parameter is only used in the method send_single_sms() and send_multiple_sms(custom_data)
language : Choose between two language formats 1 - English2 - Unicode (Regional Language) This parameter is only used in the method send_single_sms() and send_multiple_sms(custom_data)
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)
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)
template : Authorised Template number of the user.This parameter is only used in the method send_single_sms() and send_multiple_sms(custom_data)
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:

get_sms_balance(custom_data) : Get Transactional and Promotional Balance of The User.Input Parameter's Required:key Output: JSON
get_sender_id(custom_data) : Get List of Sender Ids of The User. Input Parameter's Required:key Output: JSON
get_job_report(custom_data) : Get Job Report of the User. Input Parameter's Required:key,job_id,report_dateOutput: JSON
get_sent_sms_reports(custom_data) : Get SMS sent reports of the User. Input Parameter's Required:key,report_date,product Output: JSON
send_single_sms(custom_data) : Send Single SMS. Input Parameter's Required:key,sender,mobile,language,product,message, templateOutput: JSON
send_multiple_sms(custom_data) : Send Multiple SMS. Input Parameter's Required:key,sender,mobile(multiple and comma separated),language,product,message,templateOutput: 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

Error Code
Meaning

Unauthorized
Incorrect API key or the account is blocked.

1
This error occurs when no recipients is found.

2
This error occurs when no sender name is specified.

3
Invalid Sender Id for this domain. This error appears if you use a Sender Id which is not specified for your account.

4
This error occurs when the Language id is missing or not specified. Choose between two language formats 1 - English 2 - Unicode (Regional Language)

5
This error occurs when the Product id is missing or not specified. Choose between two Product types 1 - Transactional 2 - Promotional

6
This error occurs when no Message Content is found. This error occurs when message content is missing.

11
This error occurs when the Message size exceeds the given limit. Please check your account balance and message size.

12
Mobile numbers should not be more than 500. This error occurs when the number of mobile number in multiple SMS exceeds 500.

15
This error occurs when Job Id is missing.

17
This error occurs when the Date is missing.

18
This error occurs when the Date format is invalid. The date should be in YYYY-MM-DD format.

101
This error occurs when the account has Insufficient Balance. Recharge your account to fix this issue.

102
This error occurs when API Key is not specified.

143
This error occurs when the User not found or Inactive.

151
This error occurs when Job Id and date doesn't match or the Job Id is incorrect.

142
Unauthorized IP Address. This error appears when the IP of the server which sent the GET request didn't match the whitelisted IP list.

500
This error occurs usually when the problem is on our end. Kindly, notify us immediately when you face this issue.

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