mail-n-message's Introduction

Mail-N-Message API (mnm-api)

Mail-N-message API is REST API using which someone can schedule tasks to send mail and sms through computer programs. The API makes use of way2sms API to send text messages and Flask_mail module to send emails. The scheduled mails and messages will be sent to the given email ids and mobile numbers respectively at the specified date and time. The scheduling has been done using APScheduler module in python and API has been created using Flask.

The API code is available in app.py.

Usage

import requests, json

request = {
    
    'datetime': {
        'year': 2019 #int,
        'month': 11 #int,
        'day': 29 #int,
        'hour': 19 #int - 24 hour format,
        'minute': 12 #int,
        'second': 0 #int,
    },
    
    'message': 'Hello', #str
    
    'mail': {
        'to': ['[email protected]', '[email protected]'], # list of strings
        'from': '[email protected]', #str
        'subject': 'test mail', #str
    },
    
    'sms': {
        'to': '<recipient mobile number with country code eg: +911234567890>', #str
        'from': '<sender mobile number with country code eg: +911234567890>', #str
        'apikey': '<your-way2sms-apikey>', #str
        'secret': '<your-way2sms-secret>' #str
    }
}

value = 'both'
# value = 'sms' <to only send sms. need not include mail details in request> 
# value = 'mail' <to only send mails. need not include sms details in request>
# value = 'both' <to send both mail and sms. both mail and sms details should be included>

api_url = f'https://mnm-api-v1.herokuapp.com/v1/{value}'
r = requests.post(api_url, data = json.dumps(request), headers = {'Content-Type': 'application/json'})
print(r.status_code)
print(r.json())