Push

Send push

Use this method to send mobile push notifications.

POSThttps://api.messageflow.com/v2.1/push

Authorization

APIKeyHeader

Body

application/json

applications*array of string

The id of applications to which we want to send push notification.

to*array of object

Push notification receivers

title*object

The push title that can be translated into multiple languages. Property name can have 2 characters maximum and property value maximum of 50 characters.

Example: {"pl":"test","en":"test"}

body*object

The push body that can be translated into multiple languages. Property name can have 2 characters maximum and property value maximum of 400 characters.

Example: {"pl":"test","en":"test"}

defaultLanguage*string

The default language for translating push in Unicode language identifier representation.

Example: "pl"

imagestring

The absolute URL of image. Image requirements:

Android:

aspect ratio 2/1
format JPG PNG GIF
dimensions:
min 512x256
balanced 1044x720
max 2088x1440

iOS

size < 10MB
format JPG PNG GIF
dimensions max 2436x2436

Example: "http://absolute.url/to/image"

silentboolean

Should notification be silent or not.

soundstring

The push sound. Use resource name or ‘DEAFULT’ string

Example: "sound-file.wav"

scheduleTimestring

The date the Push will be set off.

Example: "2020-01-01 12:12:12"

Pattern: /^\d{4}-\d{2}-\d{2}\s*(?:\d{2}:\d{2}(?::\d{2})?)?$/

ttlnumber

The unix timestamp parameter specifying the maximum lifetime of notification. Must be in future. The push service will try to deliver the notification to the receiver until the specified day.

Example: 1540377351

externalDataobject

The additional key/value pair you can add to the push notification. Property name can contain max of 50 signs

Example: {"test":"x","test1":false}

advancedobject

The advanced options for push notification.

actionobject

Action that should be executed after push click

actionButtonsarray of object

Two buttons for push notification. Each button can have different action.

Response

200401404500

Request was successfully processed

Body

application/json

metaobject

Additional data

dataarray of object

Request

CsharpGoJavaNodePhpPythonRubyShell

var client = new RestClient("https://api.redlink.pl/v2.1/push");
var request = new RestRequest(Method.POST);
request.AddHeader("content-type", "application/json");
request.AddHeader("authorization", "REPLACE_KEY_VALUE");
request.AddParameter("application/json", "{\"applications\":[\"XXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX\"],\"to\":[{\"receiver\":\"example-device-id\",\"externalId\":\"xxx-xxx-xxx-xxx\",\"type\":1}],\"title\":{\"pl\":\"test\",\"en\":\"test\"},\"body\":{\"pl\":\"test\",\"en\":\"test\"},\"defaultLanguage\":\"pl\",\"image\":\"http://absolute.url/to/image\",\"silent\":false,\"sound\":\"sound-file.wav\",\"scheduleTime\":\"2020-01-01 12:12:12\",\"ttl\":1540377351,\"externalData\":{\"test\":\"x\",\"test1\":false},\"advanced\":{\"subtitle\":\"subtitle-only-ios\",\"lockscreenVisibility\":1,\"icon\":{\"small\":\"/relative-icon-file-path\",\"large\":\"/relative-icon-file-path\"}},\"action\":{\"url\":\"http://absolute.url/to/redirect/on/click\",\"type\":2},\"actionButtons\":[{\"button\":1,\"icon\":\"my_icon.png\",\"action\":{\"url\":\"www.google.pl\",\"type\":1}}]}", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);

Response

200401404500

{
  "meta": {
    "numberOfErrors": 0,
    "numberOfData": 1,
    "status": 200,
    "uniqId": "00d928f759"
  },
  "data": [
    {
      "receiver": "example-device-id",
      "externalId": "xxx-xxx-xxx-xxx",
      "type": 1
    }
  ]
}