fyi.opensocial.subscribeSpaces

Changes to a group's spaces, as they happen, for one of its members: a #change for each change to a space the caller may read now, saying which space and its new revision, and nothing of what changed. A member who hears one reads again with listSpaceRecords. Members only, with service auth for this method, sent as a Bearer token or, as a browser's WebSocket can't send one, as `token`. The site's own pages hear the same changes at /space-events (server-sent events, with who's online).

Details · subscription
Kindsubscription
Authorityopensocial.fyi
Indexed

Subscription

subscription · WebSocket

Parameters

query string

cursor

integer

The seq of the last #change heard: the changes after it that the host still holds are sent first. Older than it holds, an #info OutdatedCursor comes first, and the caller should read everything again.

group

requiredstring · did

token

string

Service auth for this method, for a client that can't send an Authorization header.

Messages

DAG-CBOR frames

#change

object

#info

object

Errors

FutureCursor

No description in schema.

#change

object

Properties

rev

requiredstring

The space's revision after the change.

seq

requiredinteger

Its place among the host's changes, to resume from with cursor.

space

requiredstring · at-uri

time

string · datetime

#info

object

Properties

message

string

name

requiredstring
  • knownValues: OutdatedCursor