The Direct Trigger Push Message API based on template is used to send the following types of messages:
...
| POST | https://saas.appoxee.com/api/v3/message/direct |
|---|
Request Header
The request header must include the following authentication parameters, used to log into Appoxee:
| Name | Value |
|---|---|
| X-ACCOUNT_CODE | Your Appoxee account code. In case you don't have an account code add your Appoxee user name here as well |
| X-USERNAME | Your Appoxee user name. |
| X-PASSWORD | Your Appoxee password. |
Example Request
Trigger a "Direct" Message
Request paramters
Parameter name | Mandatory | Parameter type | Parameter value | Acceptable values | Example |
|---|---|---|---|---|---|
| template_id | yes | INT | Message template id | - | 123 |
| messages_data | yes | ARRAY | Messages data | - | [{ |
Each API request body should contain the following parameters:
Parameter name | Mandatory | Parameter type | Parameter value | Acceptable values | Example | ||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| alias | yes | STRING | Device alias | - | "mor" | ||||||
| push_body | yes | STRING | Push body text | - | "hello world!" | ||||||
| push_badge | no | INT | Push badge value | - | 5 | ||||||
| sound | no | STRING | Name of sound file | - | "greeting" | ||||||
| payload | no | OBJECT | Extra fields | - | |||||||
| ios_push_title | no |
| Push title | - | "title" | ||||||
| ios_subtitle | no |
| Push sub title | - | "sub title" | ||||||
| ios_apk_media | no |
| Push Rich content source | - | "http://pngimg.com/uploads/google/google_PNG19629.png" | ||||||
| ios_mutuable_content | no |
| Whether content is rich or not | - | 1 |
Example request
The following request will trigger template 1234 to alias "mor"
Request
{ "template_id" : 2350498 , "messages_data" : [ { "alias" : "mor" , "push_body" : "hello" , "push_badge" : 5 , "sound" : "greeting" , "payload" : { "banner" : "1234" } } ]} |
Example 2
{ "template_id": 133992002, "messages_data": [ { "alias": "goldtl72", "push_body": "Hello John please check your account credit", "push_badge": 1, "sound": "greeting", "payload": { "apx_dpl": "myapp://product/4", "banner": "1234" } }, { "alias": "shaun234", "push_body": "Hello Shaun please check your account credit", "push_badge": 2, "sound": "welcome", "payload": { "apx_dpl": "myapp://product/454", "banner": "1234" } } ] } |
|---|
HTTP Response Header
| HTTP Header Field | Value |
|---|---|
| Status Code |
|
Response body:
{ "metadata" : { "error" : false }, "links" : [], "payload" : { "template_id" : "2350498" , "messages_data" : [ { "alias" : "mor" , "push_body" : "hello" , "push_badge" : 5 , "sound" : "greeting" } ], }} |
Example 3
| { "template_id":194736, "ios_push_title":"title", "ios_subtitle":"sub title", "ios_apx_media":"http://pngimg.com/uploads/google/google_PNG19629.png", "ios_mutuable_content":1, "messages_data": [ { "alias": "mor", "push_body": "hello", "push_badge": 5, "sound": "greeting", "payload": { "apx_dpl": "myapp://product/4", "banner": "1234" } } ] } |
|---|
Response
HTTP Response Header
| HTTP Field Header | Value |
|---|---|
| Status Code |
|
Response Body:
{
"metadata": {
"error": false
},
"links": [],
"payload": {
"template_id": 194736,
"platform": "0",
"ios_push_title": "title",
"ios_subtitle": "sub title",
"ios_apx_media": "http://pngimg.com/uploads/google/google_PNG19629.png",
"ios_mutuable_content": 1,
"messages_data": [
{
"alias": "mor",
"push_body": "hello",
"push_badge": 5,
"sound": "greeting",
"payload": {
"apx_dpl": "myapp://product/4",
"banner": "1234"
}
}
]
}
}