chat.yakka.getRealtimeTicket

Issue a short-lived, single-use ticket for opening the realtime socket (ADR 0034 §3). A browser cannot set headers on a WebSocket, and a cookie is the wrong instrument across origins — so the ticket goes in the socket URL, which is why it must be worth little: it authenticates one upgrade, once, within seconds. The socket is the appview's primary surface (ADR 0011), so this is not an afterthought but the only authenticated path for most of what a client does.

Repository @yakka.chat did:plc:wpjoy2orkqq5m65vq7gg7liz namespace authority
Details · procedure
Kindprocedure
Authorityyakka.chat
Indexed

Procedure

procedure · POST

Output

application/json
Reference

#output

object

Properties

expiresAt

requiredstring · datetime

socket

requiredstring · uri

The URL to open, ticket already appended. Handed over whole so a client is never assembling an authenticated URL itself.

ticket

requiredstring