Filip/matrix-spec
1
0
Fork 0
mirror of https://github.com/matrix-org/matrix-spec synced 2026-02-04 05:13:42 +01:00
Code Issues Actions 3 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:
- 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`
@ -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
/room_keys/keys/${roomId}?version=$v`.
If no keys are found, then this endpoint returns a successful response with
body:
If the backup version exists but no keys are found, then this endpoint returns
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`
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
/room_keys/keys?version=$v`.
If no keys are found, then this endpoint returns a successful response with
body:
If the backup version exists but no keys are found, then this endpoint returns
a successful response with body:
```
{
@ -368,6 +372,10 @@ body:
}
```
Error codes:
- `M_NOT_FOUND`: The requested backup version does not exist.
#### Deleting keys
##### `DELETE /room_keys/keys/${roomId}/${sessionId}?version=$v`