Stream waits (SSE)
GET/v1/parks/{park_id}/waits/stream
Server-Sent Events for one park: subscribed, a snapshot of the whole board, then changes and park messages as they happen, each an unnamed data: line with a type field, so EventSource.onmessage receives everything. A ": ping" comment arrives every 25 seconds. Browsers pass the key as ?key=. For several parks on one connection, use the WebSocket at /v1/stream. The iOS app uses a separate opt-in socket, wss://api.parkypass.com/live/waits/{park_key}?apikey=, which sends {type:"snapshot"|"changes", park_key, rows} and answers {"type":"ping"} with {"type":"pong"}. Rows use the same current_live_waits fields. REST polling is unchanged. Upstream failures send an error and end the stream; EventSource retries after 5 seconds. Keyed streams end at the cached key verdict expiry (at most 10 minutes) and reconnect to revalidate.
Parameters
- park_idPATH · REQUIRED
- The park: a park key (magic-kingdom), the canonical park id, the park's name, or a shorthand (mk, epcot, hs, ak, dl, dca, usf, ioa, epic, ush), in any case.
- keyQUERY
- Optional developer key, for clients that cannot send headers.
Response
A text/event-stream; each data: line is one JSON message. See Errors for failures.
CACHE-CONTROL no-cache