From ca67aa7b4fe0694ac4907f2ca7af4d14341f13f3 Mon Sep 17 00:00:00 2001 From: Daniel Wagner-Hall Date: Tue, 5 Jan 2016 13:45:04 +0000 Subject: [PATCH] Tidy up guest access spec * Mention that /leave is allowed * Mention that /sync is allowed * Re-order such that the whole list of APIs fits on one screen --- specification/modules/guest_access.rst | 23 ++++++++++++++--------- 1 file changed, 14 insertions(+), 9 deletions(-) diff --git a/specification/modules/guest_access.rst b/specification/modules/guest_access.rst index cd43524b0..b66761219 100644 --- a/specification/modules/guest_access.rst +++ b/specification/modules/guest_access.rst @@ -33,21 +33,16 @@ retrieving events: * `GET /rooms/:room_id/state/:event_type/:state_key <#get-matrix-client-%CLIENT_MAJOR_VERSION%-rooms-roomid-state-eventtype-statekey>`_ * `GET /rooms/:room_id/messages <#get-matrix-client-%CLIENT_MAJOR_VERSION%-rooms-roomid-messages>`_ * `GET /rooms/:room_id/initialSync <#get-matrix-client-%CLIENT_MAJOR_VERSION%-rooms-roomid-initialsync>`_ +* `GET /rooms/:room_id/sync <#get-matrix-client-%CLIENT_MAJOR_VERSION%-sync>`_ -There is also a special version of the -`GET /events <#get-matrix-client-%CLIENT_MAJOR_VERSION%-events>`_ endpoint: - -{{guest_events_http_api}} - -They will only return events which happened while the room state had the -``m.room.history_visibility`` state event present with ``history_visibility`` -value ``world_readable``. Guest clients do not need to join rooms in order to -receive events for them. +Note that the ``/sync`` API requires an inline filter to be specified which lists +the desired room IDs. The following API endpoints are allowed to be accessed by guest accounts for sending events: * `POST /rooms/:room_id/join <#post-matrix-client-%CLIENT_MAJOR_VERSION%-rooms-roomid-join>`_ +* `POST /rooms/:room_id/leave <#post-matrix-client-%CLIENT_MAJOR_VERSION%-rooms-roomid-leave>`_ * `PUT /rooms/:room_id/send/m.room.message/:txn_id <#put-matrix-client-%CLIENT_MAJOR_VERSION%-rooms-roomid-send-eventtype-txnid>`_ Guest clients *do* need to join rooms in order to send events to them. @@ -57,6 +52,16 @@ their own account maintenance: * `PUT /profile/:user_id/displayname <#put-matrix-client-%CLIENT_MAJOR_VERSION%-profile-userid-displayname>`_ +There is also a special version of the +`GET /events <#get-matrix-client-%CLIENT_MAJOR_VERSION%-events>`_ endpoint: + +{{guest_events_http_api}} + +They will only return events which happened while the room state had the +``m.room.history_visibility`` state event present with ``history_visibility`` +value ``world_readable``. Guest clients do not need to join rooms in order to +receive events for them. + Server behaviour ---------------- Servers are required to only return events to guest accounts for rooms where