Record SDK and host-reported events
POST https://connect.seatpreevue.com/v1/events
Operation recordEvents · Events
Authentication: or no key (authenticated by the page’s Origin, or by the session). See Authentication.
Batched by the SDK; flushed every 5 s and on pagehide (with sendBeacon). No
Authorization header. A browser session's batch is authenticated by sessionId and an
Origin matching the session (missing: 403 origin_missing; another: 403 origin_not_allowed). A server session's batch (native apps, no Origin) is authenticated by
sessionId and eventsToken (missing or wrong: 401 invalid_key). An unknown or expired
session: 403 session_not_found. A key revoked since, or a suspended partner: 401 key_revoked. Accepts application/json or text/plain (for sendBeacon). Never put
personal data in props.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
Origin |
header | string | Sent by browsers; required and validated for pk_ keys, keyless sessions and browser sessions' /events. Absent for server sessions (an sk_ key from a backend; see Authentication). |
Request body
application/json: EventBatch
text/plain: string
Responses
| Status | Description | Body |
|---|---|---|
| 202 | Accepted | |
| 400 | Validation failed | Problem |
| 401 | Server session with a missing or wrong eventsToken (invalid_key); or the session's key is no longer live, or its tenant not active (key_revoked, 1.12.0) |
Problem |
| 403 | Origin, venue, scope or key type not permitted | Problem |
| 413 | Batch too large (max 100 events / 64 KB) | |
| 429 | Rate limited | Problem |