Request parsing and JSON responses shared by the gateway route handlers.
Request parsing and JSON responses shared by the gateway route handlers.
(archived-400)The answer to an archived parameter naming a view that does not exist.
The answer to an `archived` parameter naming a view that does not exist.
(query-archived request)The archive view a request asks for, or :invalid when it names one this
gateway does not have. Absent or blank is :exclude: a caller that never
heard of the archive reads the active list.
The archive view a request asks for, or `:invalid` when it names one this gateway does not have. Absent or blank is `:exclude`: a caller that never heard of the archive reads the active list.
(query-long request k)Long value of query param k, or nil when it is absent, blank or unparsable.
Ring hands back a VECTOR when a param repeats (?limit=1&limit=2), so read the
LAST value — a duplicated param is a client bug, not a ClassCastException.
Range policy belongs to the caller: 0 and negatives come back as themselves.
Long value of query param `k`, or nil when it is absent, blank or unparsable. Ring hands back a VECTOR when a param repeats (`?limit=1&limit=2`), so read the LAST value — a duplicated param is a client bug, not a ClassCastException. Range policy belongs to the caller: 0 and negatives come back as themselves.
(query-session-ids request k)A comma-separated list of session ids from one query parameter, as a set.
Absent, blank and "only commas" all mean the empty set: an overlay a device does not have is not an error, it is simply no overlay.
A comma-separated list of session ids from one query parameter, as a set. Absent, blank and "only commas" all mean the empty set: an overlay a device does not have is not an error, it is simply no overlay.
(query-str request k)Trimmed string value of query param k, or nil when it is absent or blank.
Same duplicate-param rule as query-long: the LAST value wins.
Trimmed string value of query param `k`, or nil when it is absent or blank. Same duplicate-param rule as [[query-long]]: the LAST value wins.
(session-archived-409 sid)The answer to a WRITE aimed at an archived session. The archive is READ-ONLY and the gateway is where that holds: the app and the TUI disable their controls, so a human never learns it from a refusal, but a stale screen or an SDK caller reaches these routes anyway.
The answer to a WRITE aimed at an archived session. The archive is READ-ONLY and the gateway is where that holds: the app and the TUI disable their controls, so a human never learns it from a refusal, but a stale screen or an SDK caller reaches these routes anyway.
(session-busy-409 sid)The answer to an archive aimed at work in flight: a running turn, a turn queued
behind it, or an input prompt parked on the operator. sid names the session that
is busy, which for a GROUP is the member holding the whole shelf up.
The answer to an archive aimed at work in flight: a running turn, a turn queued behind it, or an input prompt parked on the operator. `sid` names the session that is busy, which for a GROUP is the member holding the whole shelf up.
(weak-etag parts)WEAK conditional-GET validator over parts: SHA-256 of their canonical JSON.
Weak because the callers hash CONTENT and drop per-request clock samples
(server_time_ms) — two answers may differ in bytes while rendering
identically, which is exactly the case a 304 exists for.
WEAK conditional-GET validator over `parts`: SHA-256 of their canonical JSON. Weak because the callers hash CONTENT and drop per-request clock samples (`server_time_ms`) — two answers may differ in bytes while rendering identically, which is exactly the case a 304 exists for.
cljdoc builds & hosts documentation for Clojure/Script libraries
| Ctrl+k | Jump to recent docs |
| ← | Move to previous article |
| → | Move to next article |
| Ctrl+/ | Jump to the search field |