Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Use /entity routing instead of /user

...

Excerpt

Retrieves a specific push communication message for an account.

   

 

Endpoint ID:7002
Method:
Status
colourGreen
titleGET
URL:

/communication/push/

dp-key

entity/id/{

dp

entity-

key

id}/{message-id}?markAsRead=false

/communication/push/entity/ext-key/{ext-key}/{ext-type}/{message-id}

 

 dp-keydialogportal™ master key that

?markAsRead=true


entity-id

Rubiq entity ID that uniquely identifies the account to retrieve the message for

 

ext-key

External key that uniquely identifies the account to retrieve the message for 

 


ext-type

Type of external key

 


message-idID of the message to retrieve

markAsReadOptional: boolean to set the read status of the message. Default is true.
Request body:

None 


Spanstyle


white-space:pre

Response body:

JSON data containing the push communication details, and the base64 encoded message.

Code Block
titleExample – Push communication message with title, link and type
{
    "messageID": 23930553,
    "creationDate": "
2013
2014-
02
01-
18T17
08T17:17:04",
    "title": "R3JlYXQgbmV3cyBEYXZlIQ==",
    "message": "DQo8aHRtbD48aGVhZD48L2hlYWQ+PGJvZHk+PC9ib2R5PjwvaHRtbD4=",
    "link": "http://www.google.com?id=123456789",
    "type": "BreakingNews",
    "readStatus": true,
	"activityID": 12345
}

The possible response body fields are:

messageIDID of the message that was retrieved
creationDateThe date and time that the message was created
titleA base64 encoded title for the message
messageThe base64 encoded message. The decoded message can be plain text or html, depending on the message design.
linkA URL. This may be an external internet address, or an internal link to be used within an app. *
typeThe message type - either "Standard" or "BreakingNews". *
readStatusWhether the message has been marked as read
activityIDID of the activity that sent the push notification.

* Use of the "link" and "type" properties should be decided between the app developer and the content producer

Status codes:200

Message retrieved successfully

 


404
Account

Message was not found

The following sub codes may be returned:

404.1User not found
404.2External user could not be found
404.4This message could not be found