The document introduces usage of PNS Web interface.

Here are the concepts of user channel and tag channel, which must be clarified：

• user channel is named by the unique uid of mobile device. PNS will sub the uid automatically when the connection is setup (sub means join channel)
• tag channel is the mobile clients group(uid group) setup by sub API. for instance, a client sub “location:beijing”, then it will join into channel “location:beijing”, when push messages to “location:beijing”, the clients in group of “location:beijing” will receive messages. Tag channel can be treated as a group for tag push.

Developers need to POST data to Web interface, and the Web interface will return result in JSON.

If the following is configured in the file of toaster.conf:

[web]
bind localhost:8080

Then you can call Web Interface using the following Linux command, or call it by programming of HTTP:

curl –X POST –d POST_DATA http://localhost:8080/METHOD_NAME

inside

POST_DATA is POST data to PNS
METHOD_NAME is the method name to be called

METHOD_NAME: pub

POST_DATA:

"expired": "1403521931",
             "appid": "XXX",
             "channel": "xxx@qq.com",
             "channel": "xxx@gmail.com",
             "data": "hello world" 

• expired: unix timestamp, the longest time is 30 days (setting in the configuration file above). Beyond the time specified here, PNS will discard the offline messages, and you cannot query the relevant information through the Web Interface. It is worth to noting, if “expired” is greater than 0, PNS will save offline messages for the clients offline, and will send the message when the clients log in next time. If “expired” is set to 0, it means the message is an instant one, and the PNS will not save the message for the offline clients. And the clients will not get message any more when they get online.
• channel: name of user channel, you can provide multiple channels. In this method, the value of channel corresponds to UID provided by the SDK .
• data: the data for clients. It supports any format data even binary data. Under normal circumstances, you can assign JSON text to data. The following lists the instruction of data format.
• appid: appid of the APP to push. Only one value needed.

If you are using the embedded presentation template in SDK, for the Notification Bar of Android, you need to use format data in POST method, refer to the JSON string as following:

{ 
     "type":"notification", //notification bar type
    "style":"1",                    //notification bar style number
    "config":{ 
        "icondata":"XXXXXXX",   //icon file data with BASE64 encoding
        "vibrate":"1",                     //whether to vibrate when receive the message: 1 vibrating, 0 no vibrating
        "sound":"1",                       //whether to play sound: 1 sound, 0 no sound
        "title":"XXXXXX",                //notification bar title
        "ticker":"XXXXXXX",           //the rolling information
        "body":"XXXXXXX",           //notification content
        "clickconfig":{                   //define the behavior after user clicks the notification bar, please refer to the examples below
            "operation":"launchActivity", 
            "package":"com.wbkit.icclient", 
            "targetActivity":"com.wbkit.icclient.MainActivity" 
        } 
    } 
}

clickconfig Example 1: open APP (Activity)

{
 “operation”：“launchActivity”,          //operation type: open Activity
 “package” : “com.example.demo”  //APK package name
 “targetActivity”: “com.example.demo.MainActivity” //Activity
}

clickconfig Example 2: download APK and install

{
 “operation”：“download”,       //operation type: download APK
 “appname”: “fishing”             //APP name
 “dlurl”: “http://xxxxxx.apk”        //APK url
  //PS: popup installation guide of Android automatically after downloading
}

clickconfig Example 3: open a web page

{
 “operation”：“loadWebpage”,      //operation type: open a web page
  //PS: if both url and page are provided, the SDK will use url
 “url”: “http://www.baidu.com”,     //url
 “page”: “.....”            //content of page
}

Payload message template embedded

Format data as following:

{
 “type”：“transparent”, //payload type
 “config”：“{
         	“content”:“XXXXXXX”, //payload notification content
	         } ”
}

Format of returns from Web Interface:

{
            "status":      "200",
            "pushedCount": 100,
            "offCount":    1,
            "elapsed":     0.52,
            "mid":         "489c4464de66000"
         }

• status: 200 indicates success, 400 indicates the request packet format error.
• pushedCount: count of message sent. This number does not represent the number of users(devices) who received the message, it only means the server has sent data to 100 links. Only when SDK submit the receipt, the PNS server will get to know how many users(devices) received message.
• offCount: the current offline count in submitted user channel.
• elapsed: the consume time on the server push, in milliseconds, is a float type number.
• mid: the unique ID of push task for the pushing. It can be used to query task information asynchronous, such as received count, click count, message content, and so on.

tagpub is a command for the tag channel pushing, also supporting offline messages, as long as non-zero value of expired. But please note offline messages will cost more resources. If only a instant message, please set expired to 0 . METHOD_NAME: tagpub POST_DATA:

           "channel": "localtion:beijing",
           "channel": "location:guangzhou",
           "data": "hello world",
           "appid": "XXX",
           "expired": "1403521931"

• channel: tag channel name, can be more than one channel.
• data: data to send.
• appid: appid associated with the tag channels, it should only be tag channels under the App.
• expired: same as pub method.

Returns format:

       {
          "status":      "200",
          "pushedCount": 100,
          "elapsed":     0.52,
          "mid":         "489c4465de66000"
       }

All the returns have same meaning with pub method.

The method will push notification to online users or all users(devices) under appid. “expired” is used to distinguish online users and offline users. If expired is set 0, PNS will send data to online users, and do not save offline message.

METHOD_NAME: allpub POST_DATA:

           "appid": "XXX",
           "data": "hello world",
           "expired": "1403521931"

Returns format:

      {
          "status":      "200",
          "pushedCount": 100,
          "elapsed":     0.52,
          "mid":         "489c4466de66000" 
       }

Status description：

• 200 success
• 400 request packet error
• 500 server internal error (usually related to redis)