Get Message Center Messages
Use this interface to retrieve message center messages for the specified app and user.
Note: The Responsys Advanced API is generally available for all Responsys customers.
Service URL:
/rest/api/v1.3/messageCenter/apps/{appId}/users/{userId}/messages?inboxName={exampleInbox}&modifiedSince={dateTime}
Required Path Parameters:
appId
– The Responsys App ID for the app. Also known as “RI App ID”. You can locate your App ID in your Responsys account in two locations: by navigating to the Mobile App Console or navigating to Account > Manage Mobile App Configurations. Must be an integer.
userId
– Unique identifier of the user for which you want to retrieve messages.
Optional Path Parameters:
inboxName
– Name of the Message Center to retrieve messages from. If not provided, the Primary Message Center will be used.
modifiedSince
– The date and time of the last successful message retrieval. Expressed as an ISO 8601 timestamp.
Request Method:
GET
Request Header:
Authorization=<AUTH_TOKEN>
Content-Type=application/json
Request Example:
GET /rest/api/v1.3/messageCenter/apps/1/users/api.user@oracle.com/messages?inboxName=inbox1&modifiedSince=2019-01-08T10:07:29Z
Request Body - Required Properties:
Not applicable
Sample Request Body
Not applicable
Sample Response Body - Success
{
"next_req_time": "2019-02-05T07:48:29Z",
"messages": [
{
"subject": "inbox- So",
"message": "Responsys universal link",
"id": "ABEoKJcNg50lQO2ofvaWHSCQ-B1n2s5hfBN_1olgKrbtoyKJp25Ybmm-kKdUo",
"icon_url": "",
"device_id": "D4EDFAFF-8DC4-4800-9BC8-3BFBB9696276",
"richmessage_url": "null",
"deeplink_url": "null",
"sent_ts": "2019-02-04T10:06:00Z",
"message_center_name": "inbox1",
"form_link": "https://api.pushio.com/v2/null/cl/ABEmrRKC0JnnFqR7hQlS-wGuE?messageId=ABEoKJcNg50lQO2ofvaWHSCQ-B1n2s5hfBN_1olgKrbtoyKJp25Ybmm-kKdUo",
"expiry_datetime": "2019-02-11T10:06:00Z",
"user_id": "api.user@oracle.com",
"expiry_ts": "2024-04-25T19:12:00Z",
"richmessage_html": ""
},
{
"subject": "inbox- So",
"message": "Responsys universal link",
"id": "ABEmfugnqh4x8KV0WBZoDaA0vcFYcZiMnH9GiX9Phm7_5Sf1pRqGcjefBjPOY",
"icon_url": "",
"device_id": "D4EDFAFF-8DC4-4800-9BC8-3BFBB9696276",
"richmessage_url": "null",
"deeplink_url": "null",
"sent_ts": "2019-02-04T10:04:19Z",
"message_center_name": "Primary",
"form_link": "https://api.pushio.com/v2/null/cl/ABEmrRKC0JnnFqR7hQlS-wGuE?messageId=ABEmfugnqh4x8KV0WBZoDaA0vcFYcZiMnH9GiX9Phm7_5Sf1pRqGcjefBjPOY",
"expiry_datetime": "2019-02-11T10:04:19Z",
"user_id": "api.user@oracle.com",
"expiry_ts": "2024-04-25T19:12:00Z",
"richmessage_html": ""
},
{
"subject": "inbox- So",
"message": "Responsys universal link",
"id": "ABEmk2NMpqU9s1wrITi579HsQAChmM6AoqxssSEE7RAE303LP6jALRolFN9xE",
"icon_url": "",
"device_id": "D4EDFAFF-8DC4-4800-9BC8-3BFBB9696276",
"richmessage_url": "null",
"deeplink_url": "null",
"sent_ts": "2019-02-04T10:02:41Z",
"message_center_name": "inbox1",
"form_link": "https://api.pushio.com/v2/null/cl/ABEmrRKC0JnnFqR7hQlS-wGuE?messageId=ABEmk2NMpqU9s1wrITi579HsQAChmM6AoqxssSEE7RAE303LP6jALRolFN9xE",
"expiry_datetime": "2019-02-11T10:02:41Z",
"user_id": "api.user@oracle.com",
"expiry_ts": "2024-04-25T19:12:00Z",
"richmessage_html": ""
},
{
"subject": "inbox- So",
"message": "Responsys universal link",
"id": "ABEjoVKAqz6_faSk8CBeCAJQ_lRk5RQQV02KZ5nvfp5oNc1cYRb4oq-wC61IM",
"icon_url": "",
"device_id": "D4EDFAFF-8DC4-4800-9BC8-3BFBB9696276",
"richmessage_url": "null",
"deeplink_url": "null",
"sent_ts": "2019-02-04T10:01:29Z",
"message_center_name": "inbox1",
"form_link": "https://api.pushio.com/v2/null/cl/ABEmrRKC0JnnFqR7hQlS-wGuE?messageId=ABEjoVKAqz6_faSk8CBeCAJQ_lRk5RQQV02KZ5nvfp5oNc1cYRb4oq-wC61IM",
"expiry_datetime": "2019-02-11T10:01:29Z",
"user_id": "api.user@oracle.com",
"expiry_ts": "2024-04-25T19:12:00Z",
"richmessage_html": ""
},
{
"subject": "this message is for deviceID 4",
"message": "testing device ID inbox messages",
"id": "ABEvNrlJZ6YnLSjvj2SZw6JvXo6We1qtDnINW65NAz5KtL0UpgiRxXliuugyI",
"icon_url": "",
"device_id": "D4EDFAFF-8DC4-4800-9BC8-3BFBB9696276",
"richmessage_url": "null",
"deeplink_url": "null",
"sent_ts": "2019-02-01T06:13:57Z",
"message_center_name": "inbox1",
"form_link": "",
"expiry_datetime": "2019-02-08T06:13:57Z",
"user_id": "api.user@oracle.com",
"expiry_ts": "",
"richmessage_html": ""
},
{
"subject": "Inbox",
"message": "test test",
"id": "ABEskoDz4To0NZGhphOTNQo8phJrYRPmFOgSZRdTWCtRNLUnt9jALlOHVpQchb",
"icon_url": "",
"device_id": "D4EDFAFF-8DC4-4800-9BC8-3BFBB9696276",
"richmessage_url": "null",
"deeplink_url": "null",
"sent_ts": "2019-01-31T09:15:52Z",
"message_center_name": "inbox1",
"form_link": "",
"expiry_datetime": "2019-02-07T09:15:52Z",
"user_id": "api.user@oracle.com",
"expiry_ts": "",
"richmessage_html": ""
},
{
"subject": "Inbox",
"message": "test test",
"id": "ABEt8wwuOM7MOcMtwlTvKopsNDlONBZJ_3nqMDi1VKBbm5KFZmectO7EEl0kqC",
"icon_url": "",
"device_id": "D4EDFAFF-8DC4-4800-9BC8-3BFBB9696276",
"richmessage_url": "null",
"deeplink_url": "null",
"sent_ts": "2019-01-31T09:08:32Z",
"message_center_name": "inbox1",
"form_link": "",
"expiry_datetime": "2019-02-07T09:08:32Z",
"user_id": "api.user@oracle.com",
"expiry_ts": "",
"richmessage_html": ""
},
{
"subject": "6.40 User Message 2",
"message": "Regression test : user messages",
"id": "ABEvOYnZRg8AvFsKGy-P2aiPFpkax6RXhFjy1HkOQ6yZ4db0B2p9yUD6neKQ4",
"icon_url": "",
"device_id": "D4EDFAFF-8DC4-4800-9BC8-3BFBB9696276",
"richmessage_url": "null",
"deeplink_url": "null",
"sent_ts": "2019-01-30T02:14:00Z",
"message_center_name": "inbox1",
"form_link": "",
"expiry_datetime": "2019-02-06T02:14:00Z",
"user_id": "api.user@oracle.com",
"expiry_ts": "",
"richmessage_html": ""
},
{
"subject": "6.40 User Message 2",
"message": "Regression test : user messages",
"id": "ABEtGIR7LpbRrU3deYJdcrEGZjeEx9Vy139BHdyXQZiz13cAbvLTc5Fp0zFTU",
"icon_url": "",
"device_id": "D4EDFAFF-8DC4-4800-9BC8-3BFBB9696276",
"richmessage_url": "null",
"deeplink_url": "null",
"sent_ts": "2019-01-28T06:58:26Z",
"message_center_name": "inbox1",
"form_link": "",
"expiry_datetime": "2019-02-04T06:58:26Z",
"user_id": "api.user@oracle.com",
"expiry_ts": "",
"richmessage_html": ""
},
{
"subject": "6.40 User Message 2",
"message": "Regression test : user messages",
"id": "ABEoK9xK5_Y6Em3PuGDBAFtN7g_4fTklJAwKmwLD41hWyr9EZM9Orob42GTpY",
"icon_url": "",
"device_id": "D4EDFAFF-8DC4-4800-9BC8-3BFBB9696276",
"richmessage_url": "null",
"deeplink_url": "null",
"sent_ts": "2019-01-28T06:54:59Z",
"message_center_name": "inbox1",
"form_link": "",
"expiry_datetime": "2019-02-04T06:54:59Z",
"user_id": "api.user@oracle.com",
"expiry_ts": "",
"richmessage_html": ""
},
{
"subject": "User ID Message",
"message": "User ID Messages",
"id": "ABEnJisXQ-Naj1Sr_DDzgNcOJya3tVQDOdP8bjmqcWQrW093vArOdJZUtIjiGP",
"icon_url": "",
"device_id": "D4EDFAFF-8DC4-4800-9BC8-3BFBB9696276",
"richmessage_url": "null",
"deeplink_url": "null",
"sent_ts": "2019-01-28T06:42:16Z",
"message_center_name": "inbox1",
"form_link": "",
"expiry_datetime": "2019-02-04T06:42:16Z",
"user_id": "api.user@oracle.com",
"expiry_ts": "",
"richmessage_html": ""
},
{
"subject": "User ID Message",
"message": "User ID Messages",
"id": "ABEq-4ltqz-CmNOw6uMd-3DNlwyA5brdu8p6ATAyGs-2ALVnZlIOXVwwpzdNE5",
"icon_url": "",
"device_id": "D4EDFAFF-8DC4-4800-9BC8-3BFBB9696276",
"richmessage_url": "null",
"deeplink_url": "null",
"sent_ts": "2019-01-28T06:32:42Z",
"message_center_name": "inbox1",
"form_link": "",
"expiry_datetime": "2019-02-04T06:32:42Z",
"user_id": "api.user@oracle.com",
"expiry_ts": "",
"richmessage_html": ""
},
{
"subject": "User ID Message",
"message": "User ID Messages",
"id": "ABEpB1CM0D5lmR2LWJ6miKoXPbRPaVS0HWxYm_KGWwD5oFq1Ohu3xN9GQZQ97S",
"icon_url": "",
"device_id": "D4EDFAFF-8DC4-4800-9BC8-3BFBB9696276",
"richmessage_url": "null",
"deeplink_url": "null",
"sent_ts": "2019-01-28T06:30:10Z",
"message_center_name": "inbox1",
"form_link": "",
"expiry_datetime": "2019-02-04T06:30:10Z",
"user_id": "api.user@oracle.com",
"expiry_ts": "",
"richmessage_html": ""
},
{
"subject": "Device ID Message",
"message": "Device ID Messages",
"id": "ABEoZYHIKB6wf3qMi6Q8FrPkYwHq_OKAvd0hn8Zy1x9vKXXKNBojeLdGMpWDR8",
"icon_url": "",
"device_id": "D4EDFAFF-8DC4-4800-9BC8-3BFBB9696276",
"richmessage_url": "null",
"deeplink_url": "null",
"sent_ts": "2019-01-28T06:23:38Z",
"message_center_name": "inbox1",
"form_link": "",
"expiry_datetime": "2019-02-04T06:23:38Z",
"user_id": "api.user@oracle.com",
"expiry_ts": "",
"richmessage_html": ""
}
],
"links": [
{
"rel": "self",
"href": "/rest/api/v1.3/messageCenter/apps/1/users/api.user@oracle.com/messages ?inboxName=inbox1&modifiedSince=2019-01-08T10:07:29Z",
"method": "GET"
}
]
}
Sample Responses - Failure
400 Not Found
App ID is not a valid number: Requests fail if the App ID supplied is not a valid number. The error resembles:
{
"type": "",
"title": "Invalid request parameters",
"errorCode": "INVALID_PARAMETER",
"detail": "APP ID is not a valid number",
"errorDetails": []
}
Invalid modifiedSince date format: Requests fail if the modifiedSince date format is not an ISO 8601 timestamp:
{
"type": "",
"title": "Invalid request parameters",
"errorCode": "INVALID_PARAMETER",
"detail": "The modifiedSince Timestamp is invalid. Please provide the modifiedSince Timestamp as an ISO8601 Timestamp value. ",
"errorDetails": []
}
App ID does not exist: Requests fail if the App ID supplied in the request does not exist. The error resembles:
{
"type":"",
"title":"Message Center Exception",
"errorCode":"MESSAGE_CENTER_EXCEPTION",
"detail":"There is no such Application ID",
"errorDetails":[]
}
Inbox name does not exist: Requests will fail if the inboxName does not match a Message Center for the application provided. The error response will resemble the following:
{
"type":"",
"title":"Message Center Exception",
"errorCode":"MESSAGE_CENTER_EXCEPTION",
"detail":"There is no such named Message Center for this Application",
"errorDetails":[]
}
Error communicating with Push API: If there’s an error communicating with the Push API, the error response will resemble the following:
{
"type":"",
"title":"Message Center Exception",
"errorCode":"MESSAGE_CENTER_EXCEPTION",
"detail":"Could not fetch data",
"errorDetails":[]
}