code | type | title |
---|---|---|
true |
page |
join |
Joins a previously created subscription.
Due to the synchronous nature of the HTTP protocol, real-time messaging is not supported
{
"controller": "realtime",
"action": "join",
"body": {
"roomId": "<subscription identifier>"
},
// optional
"volatile": {}
}
volatile
: subscription information, used in user join/leave notifications.
roomId
: subscription identifier, returned by Kuzzle during upon a successful subscription
Returns a roomId
property containing the subscription identifier.
{
"status": 200,
"error": null,
"index": null,
"collection": null,
"controller": "realtime",
"action": "subscribe",
"volatile": {},
"requestId": "<unique request identifier>",
"result": {
"roomId": "<unique Kuzzle room identifier>"
}
}