Limits
Request sizes, batch sizes and the other fixed bounds of the gateway and the SDKs.
On this page
The fixed bounds of the gateway and the SDKs. Each one keeps a busy site, a misbehaving client or a flood from costing more than it should, and each is enforced in code, not only documented.
Gateway endpoints
| Endpoint | Used by | Request body, at most | Other bounds |
|---|---|---|---|
POST /v1/b | The browser part, the Shopify pixel | 32 KB | Public key; page and origin must be on the site's domain |
POST /v1/r | The recorder | 2 MB | 40 chunks and 5 MB of recorded data per visit; no chunks for a visit idle for more than 35 minutes |
POST /v1/s | The server part, orders, UCP reports | 256 KB | 100 events per request (events after the first 100 are ignored); meta.dropped a whole number from 0 to 1,000,000 |
GET /v1/stats | Scripts, with a "Send + read" key | days from 1 to 90 | |
POST /v1/audits | Scripts, with a "Send + read" key | 4 KB | Pages on the site's own, verified domain only |
A site stores at most 4,000 recording chunks, and 300 MiB of stored (compressed) recording data, in any 24 hours.
Rate limits. Every endpoint is rate-limited per client address, and /v1/s per key as well. A request over a limit gets 429 with {"error":"Too many requests"} or {"error":"Too many requests for this key"}, and no Retry-After header. Nothing in it was written, so it can be sent again later; @parlox/server does that for its batches.
Answers. The gateway answers only once the database has confirmed the write; 503 means it did not confirm it. The browser part resends an unconfirmed beacon, and the gateway drops one it already has. @parlox/server does not resend a batch after a 503, since it may have been stored, and counts it as not confirmed instead. A beacon with an unknown key, or from a page outside the site's domain, is answered 204 and not stored.
Values the gateway keeps
| Field | Kept as |
|---|---|
value (browser), value_cents (server) | Cents, a whole number from 0 to 100,000,000,000 |
currency | Three capital letters, else dropped |
items | A whole number |
order_id, item_id | Text, cut to 64 characters |
step | Lowercase letters and underscores, up to 20 characters, else dropped |
A visit id (sid) | 16 to 32 lowercase hexadecimal characters, else not joined to a visit |
The browser part
| Bound | Value |
|---|---|
| Visit id lifetime | 30 minutes with no activity, in one tab |
| Outbox of unanswered beacons | 30 beacons, 10 minutes, 4 attempts each |
| Events waiting on one page | 100 at a time, 500 per page |
track() calls queued before Parlox starts (before init, or in the tag's stub) | 100; a consent decision in the stub is never dropped |
| Data-layer messages held before the page opens | 50 |
| A click's label | 60 characters, masked |
| A clicked control's accessible name | 80 characters, masked (up to 1.0.3 it could carry a wrapped block's text: Masking) |
| Fields in a page's friction summary | 30 |
| Recording, per visit | 30 minutes, 40 chunks, 5 MB |
The server part
| Bound | Value |
|---|---|
| A report or an order sent on its own | Gives up after 2 seconds (timeoutMs) |
| A batch (long-running servers) | 100 reports, 200,000 bytes, 10 seconds; one request at a time |
| The queue (long-running servers) | 1,000 reports; when full, the oldest is dropped and counted |
| Reports sent at once in a process | 64; the excess is counted, not sent |
| Orders posted at the same time | 10 (maxPurchasesInFlight) |
| UCP reports posted at the same time | 10, apart from orders (maxUcpReportsInFlight) |
| Retries | Only a batch Parlox provably did not store: 3 more attempts, 3 seconds apart or after Retry-After (at most 60 seconds) |
flush() | 30 seconds by default |
| A report's fields | Path 2,000 characters, user agent 1,000, Referer 2,000 |
Keys
| Bound | Value |
|---|---|
| Active secret keys per site | 20 |
| A key's name | 1 to 80 characters |
| A key's note | Up to 200 characters |
| Grace period when replacing a key | None, 24 hours or 7 days |