matrix-doc/proposals/2320-identity-versions.md

36 lines
1.2 KiB
Markdown
Raw Normal View History

# Versions information for identity servers
2019-10-15 15:34:02 +00:00
The client-server API currently specifies a `/versions` endpoint that allows
2020-02-05 12:25:50 +00:00
clients to know what version of that API are implemented by the server.
Identity servers could benefit from that endpoint as both homeservers and
clients interact with them, and therefore could know which features they can
expect a given identity server to implement by looking at the versions of the
API it claims to support.
## Proposal
2020-02-05 12:29:12 +00:00
This proposal adds the following endpoint to the identity server API.
2019-11-07 15:45:58 +00:00
### `GET /_matrix/identity/versions`
This endpoint serves information about the versions of the identity server API
this identity server supports. Its response uses the following format:
```json
{
"versions": [
"r0.1.0",
"r0.2.0",
"r0.2.1",
]
}
```
## Alternative solutions
2019-11-07 15:45:58 +00:00
Another solution which was considered was using the status check endpoint ([`GET
/_matrix/api/v1`](https://matrix.org/docs/spec/identity_service/r0.2.0#get-matrix-identity-api-v1))
2019-11-07 15:45:58 +00:00
to serve this information. This solution was discarded because it's using a
versioned endpoint, which doesn't make sense to advertise the supported versions
2020-02-05 12:25:50 +00:00
of the API to use.