Get message history
deprecated
This endpoint has been deprecated and may be removed in future versions of the API.
Path Parameters |
---|
sub_key string — REQUIREDYour app's subscribe key from Admin Portal. Example:
|
channel string — REQUIREDThe channel name to perform the operation on. Example:
|
Query Parameters |
---|
stringtoken booleanIf false, 0, or not provided, the returned start and end Timetoken values will be returned as long ints. If 1, or true, the start and end Timetoken values will be returned as strings. |
count integerThe maximum number of messages to return per response. If the count parameter is not provided, the server will default to the maximum value of 100. When the count parameter is provided, you may request between 1 and 100 messages. Example:
|
reverse booleanDirection of time traversal. Default is false, which means timeline is traversed newest to oldest. |
start numberTimetoken delimiting the start of time slice (exclusive) to pull messages from. If provided, lets you select a start date, in Timetoken format. If not provided, it will default to current time. Page through results by providing a start OR end time token. Retrieve a slice of the time line by providing both a start AND end time token. start is exclusive, that is, the first item returned will be the one immediately after the start Timetoken value. Example:
|
end numberTimetoken delimiting the end of time slice (inclusive) to pull messages from. If provided, lets you select an end date, in Timetoken format. Page through results by providing a start OR end time token. Retrieve a slice of the time line by providing both a start AND end time token. End is inclusive, that is, if a message is associated exactly with the end Timetoken, it will be included in the result. Example:
|
include_token booleanpass true to recieve a timetoken with each history message. Defaults to false |
auth stringString which is either the auth key (PAM v2) or a valid token (Access Manager) used to authorize the operation if access control is enabled. Example:
|
uuid stringA UTF-8 encoded string of up to 92 characters used to identify the client. Example:
|
include_meta booleanSet to true to include metadata with returned messages. This metadata is set using the meta parameter with the publish operation. Default is false. Example:
|
signature stringSignature used to verify that the request was signed with the secret key associated with the subscriber key. If Access Manager is enabled, either a valid authorization token or a signature are required. See Access Manager documentation for details on how to compute the signature. |
timestamp integerUnix epoch timestamp used as a nonce for signature computation. Must have no more than ± 60 second offset from NTP. Required if |
Responses | ||
---|---|---|
200 Success.
| ||
400 Invalid request.
| ||
403 Do not have permission
|