Push Notifications API

Push Notifications API is a simple Android app for displaying notifications on your phone through a REST-API.
It is a tool for developers that need a easy way to post notifications to their phone. The application requires an API to handle all the notifications. There is a working example of a Python REST-API in the api folder that works with the Android app. You can customize the API to your liking.

The application is great for IoT (Internet of Things). You could for example post a notification to your phone every time your garden needs watering when a sensor has detected the level of soil moisture to be low. The possibilites are up to you!

You can download the Android app through Google Play or download the latest apk from the releases.

• Configuration
  In the configuration tab, you can configure the endpoint which the application will listen to for the notifications.
  You can edit the poll time for each request to spare your phone's battery.
• Service
  In the service tab, you can toggle the notification service.

Navigate to api/ and run

python app.py

The app will by default run on port 5000 and the endpoint for the notifications are /

This can be changed in the config.ini file

Example using curl

curl '127.0.0.1:5000' \
--header 'Content-Type: application/json' \
--data '{
   "title": "Foo Bar Baz!",
    "body": "Lorem ipsum dolor sit amet, consectetur adipiscing elit."
}'

Response

{
   "status": 201,
   "message": "Successfully created notification",
   "data": {
       "title": "Foo Bar Baz!",
       "body": "Lorem ipsum dolor sit amet, consectetur adipiscing elit."
   }
}

curl '127.0.0.1:5000'

Response

{
   "status": 200,
   "message": "Polled last notification",
   "data": {
       "title": "Foo Bar Baz!",
       "body": "Lorem ipsum dolor sit amet, consectetur adipiscing elit."
   }
}

Please report issues using GitHub's issues tab.

Push Notifications API is under the MIT LICENSE.