Skip to content
RallyHere Docs
GitHub

Long Poll For Notifications Self

GET
/notification/v1/playerid/me/stream/notification/lp

This endpoint will return notifications newer than exclude_before. This endpoint returns notifications from older to newer, which is the opposite of the paging API.

This operation is a long-poll. That means we will keep the connection open until we get any notification or until the passed in deadline (to the best of our ability). Once one of these happens, we will return the notifications found.

Requires permissions: Any of notification:playerid:*,notification:playerid:read

Authorizations

  • HTTPBearerHeadersOrCookie

Parameters

Query Parameters

max_page_size

Max number of entries to return at one time

integer
default: 10 >= 1 <= 100

Max number of entries to return at one time

exclude_before

All notifications including and before this (chronologically) provided id will be ignored when returning results. You cannot depend on the format of this string, and it must be considered opaque

string

All notifications including and before this (chronologically) provided id will be ignored when returning results. You cannot depend on the format of this string, and it must be considered opaque

offset_reset_strategy

When exclude_before is not found in the stream or not given, begin streaming messages from the earliest/latest message

string
Allowed values: latest earliest

When `exclude_before` is not found in the stream or not given, begin streaming messages from the earliest/latest message

deadline

We will try to the best of our ability to return by this deadline, even when we have no notifications. Value should be in seconds

integer
default: 30 <= 900

We will try to the best of our ability to return by this deadline, even when we have no notifications. Value should be in seconds

Responses

200

Successful Response

object
notifications

List of notifications

Array<object>
default:
object
message
required

Base Message for the notification

string
<= 4096 characters
rh_url

Path to get additional data about this notification

string
>= 1 characters <= 4096 characters
custom_data

Custom values for the notification

object
key
additional properties
string
>= 1 characters <= 4096 characters
etag

ETag for the resource at rh_url at the time of this notification

string
>= 1 characters
notification_id
required

Unique Identifier for the notification. You cannot depend on the format of this string, and it must be considered opaque

string
created
required

When this notification was added

string format: date-time

403

Error Codes:

  • insufficient_role - Insufficient Role access
  • auth_malformed_access - Invalid Authorization - malformed access token
  • auth_invalid_key_id - Invalid Authorization - Invalid Key ID in Access Token
  • auth_token_format - Invalid Authorization - {}
  • auth_not_jwt - Invalid Authorization
  • auth_invalid_version - Invalid Authorization - version
  • auth_token_expired - Token is expired
  • auth_token_sig_invalid - Token Signature is invalid
  • auth_token_unknown - Failed to parse token
  • auth_token_invalid_claim - Token contained invalid claim value: {}
object
auth_success
boolean
default: true
error_code
required
string
desc
required
string

422

Validation Error

object
detail
Array<object>
object
loc
required
Array
msg
required
string
type
required
string