Interact with PingSMS API
Project description
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
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()
andget_sent_sms_reports()
- product : Choose between two product types
1 - Transactional
2 - Promotional
This parameter is only used in the methodsend_single_sms()
andsend_multiple_sms(custom_data)
- language : Choose between two language formats
1 - English
2 - Unicode (Regional Language)
This parameter is only used in the methodsend_single_sms()
andsend_multiple_sms(custom_data)
- sender : User's approved 6 characters Sender Id.
This parameter is only used in the methodsend_single_sms()
andsend_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 methodsend_single_sms()
andsend_multiple_sms(custom_data)
- template : Authorised Template number of the user.
This parameter is only used in the methodsend_single_sms()
andsend_multiple_sms(custom_data)
- message : Authorised message format against the Template number.
This parameter is only used in the methodsend_single_sms()
andsend_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_date
Output: 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, template
Output: JSON - 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
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
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for pingsms_api-1.0.3-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 8696e2994e904f72a2c58d5a1078489d06ad0e863ed0b207b8054a992b7e199b |
|
MD5 | 37caf73e9618a2a808e8dd29bf29b481 |
|
BLAKE2b-256 | 812ba4fdc363415e435ec1525e0c0c6c54565fa8824d8a8bd1aef80bb43752b0 |