Introduction

AirNotifier is an user friendly yet powerful application server for sending real-time notifications to mobile and desktop applications. AirNotifier provides an unified web service interface to deliver messages to multi devices using multi protocols, it also features a web based administrator UI to configure and manage services.

Supported devices

• International SMS (uses clickatell, credits required)
• iPhone/iPad devices (APNS protocol)
• Android devices (GCM protocol)
• Windows 7.1/8 phone (MPNS protocol)
• Windows 8.1 phone (WNS protocol)
• Windows 8.1 desktop (WNS protocol)

Features

• Open source application server, you can install on your own server, own your data
• Subscribe to multi channels
• Unlimited number of devices and channels
• API access control
• Web-based UI to configure
• Broadcase notifications
• Access key management
• Logging activities
• Apple Feedback API
• GCM broadcast API

Push notification examples

Sending basic notification to iOS devices

POST /api/v2/push HTTP/1.1
X-AN-APP-NAME: moodlemobileapp
X-AN-APP-KEY: b2b56dbb
Content-Type: application/json
{
    "device": "ios",
    "token": "FE66489F304DC75B8D6E8200DFF8A456E8DAEACEC428B427E9518741C92C6660",
    "alert": "Hello from AirNotifier",
    "sound": "Submarine.aiff",
    "badge": 1
}

SMS

POST /api/v2/push HTTP/1.1
X-AN-APP-NAME: moodlemobileapp
X-AN-APP-KEY: b2b56dbb
Content-Type: application/json
{
    "device": "sms",
    "token": "61412345987 [phone no]",
    "alert": "SMS message goes here"
}

Sending toast type notification to windows 8.1 devices

POST /api/v2/push HTTP/1.1
X-AN-APP-NAME: moodlemobileapp
X-AN-APP-KEY: b2b56dbb
Content-Type: application/json
{
    "device": "wns",
    "token": "https:\/\/sin.notify.windows.com\/?token=AgYAAACDWksZrGbln5sUbP6D3F%2b9ddjptarcZ%2f9vJsDwCt16EHiupJaRddEXJ8BEfx4SE5slxQlB6iknY7zdUEXFayFclNXCIYp6CWnMTYSHGVRySO7aglj6%2b09wTBYqBFxFuoA%3d",
    "alert": "alert contetnt",
    "wns": {
        "type": "toast",
        "template": "ToastImageAndText01",
        "image": ["image1"],
        "text": ["test1"]
    },
    "extra": {
        "processor":"moodle",
        "data":{"key1":"param1 value","key2":"param2 value"}
    }
}

Sending multiple push notification with one call

POST /api/v2/multipush HTTP/1.1
X-AN-APP-NAME: moodlemobileapp
X-AN-APP-KEY: b2b56dbb
Content-Type: application/json
{ 
 "notifications":[
	{
	    "device": "ios",
	    "token": "9b1a98420d08eb3331d98ff73ada3a9bdacc9a3bde25743d4af823d8ab83009c",
	    "alert": "Grazie per averci favorito",
	    "sound": "default",
	    "badge": 1,
		"custom": {
			"registration-ids": "9b1a98420d08eb3331d98ff73ada3a9bdacc9a3bde25743d4af823d8ab83009c",
			"data": {
				"body": "Grazie per averci favorito",
				"chatID": "374hf9cr8er8r93jc943948cijvdndimdi67fd78sf9",
				"data-from": "LocalFocus",
				"to": "Monical",
				"type": "broadcast"
			}
		}
	},
	{
	    "device": "android",
	    "token": "dUDjHeeJD-A:APA91bHeZmFcZUieSoArbfXelRd2KK8Em7YGXMblN3C7ekzBvOPXNCL3AfS2q7-P3v_mPPNZnY6YgDS61kKd2CWfbEMbTywxvcZLEI6M64zhulqjmm1KJOIfNx1mQpAh1vSvsxPlzSQo",
	    "alert": "Grazie per averci favorito",
	    "sound": "default",
	    "badge": 1,
		"extra": {
			"registration-ids": "dUDjHeeJD-A:APA91bHeZmFcZUieSoArbfXelRd2KK8Em7YGXMblN3C7ekzBvOPXNCL3AfS2q7-P3v_mPPNZnY6YgDS61kKd2CWfbEMbTywxvcZLEI6M64zhulqjmm1KJOIfNx1mQpAh1vSvsxPlzSQo",
			"data": {
				"body": "Grazie per averci favorito",
				"chatID": "ceiuef9h8934c39m0c9mf9i0ki3rdk903mdr989384m",
				"data-from": "LocalFocus",
				"to": "Harambe",
				"type": "broadcast"
			}
		}
	}
  ]	
}

Installation

Please read Installation guide

Configuration

airnotifier.conf is the config file, options:

• pemdir: The directory storing certificates
• passwordsalt: passwordsalt
• masterdb: MongoDB database name
• appprefix: Prefix added to app database name

Web service documentation

• Web service interfaces

Requirements

• Python 2.7.9+
• MongoDB 2.0+
• Tornado 3.0+

Copyright

Copyright (c) Dongsheng Cai and individual contributors