Filip/matrix-spec
1
0
Fork 0
mirror of https://github.com/matrix-org/matrix-spec synced 2026-03-26 04:54:10 +01:00
Code Issues Actions 1 Packages Projects Releases Wiki Activity

distinguish between retrieving an empty backup and a nonexistent backup

Browse source
This commit is contained in:
Hubert Chathi 2018-10-30 14:09:40 -04:00
parent 7713a0f402
commit 3918ed3c38
1 changed files with 14 additions and 6 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

20
proposals/1219-storing-megolm-keys-serverside.md
View file

@ -333,7 +333,8 @@ On success, returns a JSON object in the same form as the request body of `PUT
Error codes: Error codes:
- M_NOT_FOUND: The session is not present in the backup. - M_NOT_FOUND: The session is not present in the backup, or the requested
backup version does not exist.
##### `GET /room_keys/keys/${roomId}?version=$v` ##### `GET /room_keys/keys/${roomId}?version=$v`
@ -342,8 +343,8 @@ Retrieve the all the keys for the given room from the backup.
On success, returns a JSON object in the same form as the request body of `PUT On success, returns a JSON object in the same form as the request body of `PUT
/room_keys/keys/${roomId}?version=$v`. /room_keys/keys/${roomId}?version=$v`.
If no keys are found, then this endpoint returns a successful response with If the backup version exists but no keys are found, then this endpoint returns
body: a successful response with body:
``` ```
{ {
@ -351,6 +352,10 @@ body:
} }
``` ```
Error codes:
- `M_NOT_FOUND`: The requested backup version does not exist.
##### `GET /room_keys/keys?version=$v` ##### `GET /room_keys/keys?version=$v`
Retrieve all the keys from the backup. Retrieve all the keys from the backup.
@ -358,9 +363,8 @@ Retrieve all the keys from the backup.
On success, returns a JSON object in the same form as the request body of `PUT On success, returns a JSON object in the same form as the request body of `PUT
/room_keys/keys?version=$v`. /room_keys/keys?version=$v`.
If the backup version exists but no keys are found, then this endpoint returns
If no keys are found, then this endpoint returns a successful response with a successful response with body:
body:
``` ```
{ {
@ -368,6 +372,10 @@ body:
} }
``` ```
Error codes:
- `M_NOT_FOUND`: The requested backup version does not exist.
#### Deleting keys #### Deleting keys
##### `DELETE /room_keys/keys/${roomId}/${sessionId}?version=$v` ##### `DELETE /room_keys/keys/${roomId}/${sessionId}?version=$v`