wholetrans/docs-matrix-spec
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity

Merge pull request #3336 from lukaslihotzki/include-peek-events

Browse source 
OpenAPI: include peekEvents
This commit is contained in:
Alexey Rusakov 2021-08-17 14:12:31 +02:00 • committed by Richard van der Hoff
commit 6d2c388144
2 changed files with 7 additions and 3 deletions
Download patch file Download diff file Expand all files Collapse all files

1
changelogs/client_server/newsfragments/3336.clarification Normal file
View file

@ -0,0 +1 @@
Disambiguate getEvents and peekEvents, and include both in swagger.

9
data/api/client-server/peeking_events.yaml
View file

@ -27,9 +27,11 @@ produces:
securityDefinitions: securityDefinitions:
$ref: definitions/security.yaml $ref: definitions/security.yaml
paths: paths:
"/events": # With an extra " " to disambiguate from the getEvents endpoint
# The extra space makes it sort first for what I'm sure is a good reason.
"/events ":
get: get:
summary: Listen on the event stream. summary: Listen on the event stream of a particular room.
description: |- description: |-
This will listen for new events related to a particular room and return This will listen for new events related to a particular room and return
them to the caller. This will block until an event is received, or until them to the caller. This will block until an event is received, or until
@ -103,4 +105,5 @@ paths:
- "$ref": "../../event-schemas/schema/core-event-schema/room_event.yaml" - "$ref": "../../event-schemas/schema/core-event-schema/room_event.yaml"
400: 400:
description: "Bad pagination `from` parameter." description: "Bad pagination `from` parameter."
# No tags to exclude this from the swagger UI - use the normal version instead. tags:
- Room participation