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

Add error codes from MSC4178 (#1944)

Browse source 
* Add error codes from MSC4178

* changelog

* Put changelog in the right place

* Move newsfile

* Add the codes to the right endpoint

* Also add M_THREEPID_IN_USE

which was always used and is specified in the IS API, but not in the
C/S API. We decided this was well-specced enough that it didn't need
its own MSC.
This commit is contained in:
David Baker 2024-12-11 09:48:26 +00:00 • committed by GitHub
parent f819403bd5
commit 9198182f1a
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
3 changed files with 21 additions and 6 deletions
Download patch file Download diff file Expand all files Collapse all files

1
changelogs/client_server/newsfragments/1944.feature Normal file
View file

@ -0,0 +1 @@
Add error codes to requestToken endpoints (MSC4178).

7
content/client-server-api/_index.md
View file

@ -222,6 +222,13 @@ only read state (e.g.: [`/sync`](#get_matrixclientv3sync),
The user is unable to reject an invite to join the server notices room.
See the [Server Notices](#server-notices) module for more information.
`M_THREEPID_MEDIUM_NOT_SUPPORTED`
The homeserver does not support adding a third party identifier of the given medium.
`M_THREEPID_IN_USE`
The third party identifier specified by the client is not acceptable because it is
already in use in some way.
#### Rate limiting
Homeservers SHOULD implement rate limiting to reduce the risk of being

17
data/api/client-server/administrative_contact.yaml
View file

@ -488,9 +488,13 @@ paths:
"400":
description: |-
The third-party identifier is already in use on the homeserver, or
the request was invalid. The error code `M_SERVER_NOT_TRUSTED`
can be returned if the server does not trust/support the identity server
the request was invalid. Error codes that can be returned are:
* `M_THREEPID_IN_USE`: The email supplied cannot be bound because is is already
associated with a different Matrix ID.
* `M_SERVER_NOT_TRUSTED`: The server does not trust/support the identity server
provided in the request.
* `M_THREEPID_MEDIUM_NOT_SUPPORTED`: The homeserver does not support adding email addresses.
* `M_INVALID_PARAM`: The email address given was not valid.
content:
application/json:
schema:
@ -547,9 +551,12 @@ paths:
"400":
description: |-
The third-party identifier is already in use on the homeserver, or
the request was invalid. The error code `M_SERVER_NOT_TRUSTED`
can be returned if the server does not trust/support the identity server
provided in the request.
the request was invalid. Error codes that can be returned are:
* `M_THREEPID_IN_USE`: The phone number supplied cannot be bound because is is already
associated with a different Matrix ID.
* `M_SERVER_NOT_TRUSTED`: The server does not trust/support the identity server
* `M_THREEPID_MEDIUM_NOT_SUPPORTED`: The homeserver does not support adding phone numbers.
* `M_INVALID_PARAM`: The phone number given was not valid.
content:
application/json:
schema: