Travis Ralston
b8f1f37927
Remove incorrect id_server param from IS spec
...
Fixes https://github.com/matrix-org/matrix-doc/issues/2118
2019-06-12 15:29:25 -06:00
Travis Ralston
56745c76aa
Clarify that submit_url being not present only matters for r0.5
2019-06-11 09:22:02 -06:00
Travis Ralston
ca8b539b2f
humans prefer to be treated as people
2019-06-11 08:47:25 -06:00
Andrew Morgan
2068cba598
Clients should submit a POST request
2019-06-10 09:14:25 +01:00
Andrew Morgan
d1fde0837a
Consolidate id_server into ref. id_server/next_link are ignored
2019-06-10 09:06:13 +01:00
Andrew Morgan
ab0c1bc054
Add changelog, update imperative check, rename sid.yaml
2019-06-10 08:41:35 +01:00
Andrew Morgan
fe23de7d7f
A SMS -> An SMS
2019-06-10 05:20:15 +01:00
Andrew Morgan
046a834488
Slight code cleanup
2019-06-09 22:04:58 +01:00
Andrew Morgan
525bedf8e1
Fix refs
2019-06-09 20:10:44 +01:00
Andrew Morgan
fba61941af
Move submit_url responses to ref
2019-06-09 20:02:57 +01:00
Andrew Morgan
0ded484276
Address review comments
2019-06-09 16:10:44 +01:00
Andrew Morgan
1776ba28d3
Address review comments
2019-06-08 18:52:38 +01:00
Andrew Morgan
8a6ef187db
more object!
2019-06-07 17:52:17 +01:00
Andrew Morgan
62910a28cc
Merge branch 'master' into anoa/hs_3pid_tokens
...
* master:
Update example
Fix 404s in links from room v1 spec
Provide a more complete example of a "minimally-sized event"
Revert signature change for redactable event test
Clarify how many PDUs are in a given transaction object
Clarify that the server shouldn't process retries for UIA
Clarify when authorization and rate-limiting are not applicable
Skip over partial event definitions in examples
Rename example to invite_room_state
Shorten references to StrippedState in s2s spec
Fix examples of StrippedState in s2s spec
Clarify exactly what StrippedState is
Clarify that UIA stages cannot be attempted twice
Fix test vectors with invalid JSON and signature
Spec 3PID unbind API
Spec MSISDN UIA support
2019-06-07 15:55:04 +01:00
Andrew Morgan
3148184052
HS' can send 3PID token. Add a new submit_url field
2019-06-07 15:54:51 +01:00
Travis Ralston
0463084924
Spec 3PID unbind API
...
As per [MSC1915](https://github.com/matrix-org/matrix-doc/pull/1915 )
Implementation proof:
* https://github.com/matrix-org/synapse/pull/4982
* https://github.com/matrix-org/sydent/pull/160
The only alteration made which differs from the proposal is clarity on how to handle homeservers not knowing the `id_server`. All other differences are unintentional.
2019-05-28 15:05:41 -06:00
Konstantinos Sideris
192a6c2ab9
Use example.org on examples instead of domain.com which is a real domain
...
Signed-off-by: Konstantinos Sideris <sideris.konstantin@gmail.com>
2018-09-02 17:58:21 +03:00
Travis Ralston
7d34995ece
It's actually an "identity server implementing the Identity Service API"
...
Also add a note about appservices being special.
2018-08-31 15:35:32 -06:00
Travis Ralston
7ac76fa27c
Actually we're going with "identity server" afterall
2018-08-31 15:04:00 -06:00
Travis Ralston
ec248b436f
Identity Service is lowercase
2018-08-31 15:04:00 -06:00
Travis Ralston
cc0badaaa1
Fix all naming cases of "identity service"
...
Fixes https://github.com/matrix-org/matrix-doc/issues/1396
Includes some "homeserver" fixes too. This commit does not include historical documentation or notes.
2018-08-31 15:04:00 -06:00
Travis Ralston
1261da209d
Fix wording for the homeserver not allowing a particular 3pid
2018-08-31 14:38:22 -06:00
Travis Ralston
824ce22caa
Add additional clarity to the requestToken errors
2018-08-31 11:41:46 -06:00
Travis Ralston
5bb7eca8e8
English
2018-08-31 11:37:37 -06:00
Travis Ralston
60dd9231e0
Don't explain how the IS might accept a 3pid
...
The IS is bound to it's own set of specifications, and if the client chose this API then they should be aware of the risks but not necessarily arbitrary alternatives.
2018-08-31 11:26:28 -06:00
Travis Ralston
63fdd72f73
Fix error description on /account/3pid/email/requestToken
2018-08-31 11:24:35 -06:00
Travis Ralston
a4c2b2b905
General clarity and spelling for the requestToken APIs
2018-08-31 10:32:30 -06:00
Travis Ralston
dfaed5b525
Clean up and flesh out all three editions of the /requestToken API
...
Fixes https://github.com/matrix-org/matrix-doc/issues/1634
Addresses some of https://github.com/matrix-org/matrix-doc/issues/1396
2018-08-30 18:18:08 -06:00
Travis Ralston
5da3072eef
Wording change ('may not' has a special meaning)
2018-08-30 16:32:14 -06:00
Travis Ralston
8bcd7d26e3
/3pid/delete returns an empty object
2018-08-30 15:28:43 -06:00
Travis Ralston
390f1c16f7
Remove mentions of identity services from /3pid/delete
...
This will be covered by https://github.com/matrix-org/matrix-doc/issues/1194
For now, we can accept that homeservers may try to unbind, however clients should not rely on it.
2018-08-30 15:27:36 -06:00
Travis Ralston
b4be11af42
Document POST /account/3pid/delete
...
Fixes https://github.com/matrix-org/matrix-doc/issues/985
Includes documentation for https://github.com/matrix-org/synapse/pull/3667
Raises https://github.com/matrix-org/matrix-doc/issues/1566
2018-08-26 20:41:34 -06:00
Travis Ralston
a803d9d077
Document `validated_at` and `added_at` on GET /3pid
...
Fixes https://github.com/matrix-org/matrix-doc/issues/661
2018-08-26 20:39:53 -06:00
Hubert Chathi
f5dc0eaed2
document msisdn-related endpoints in IS ( #1507 )
...
* add msisdn endpoints in Identity Server spec
* add in CS endpoints that use the IS msisdn endpoints
2018-08-17 12:00:13 -04:00
Travis Ralston
caa6d4d9ad
Give all errors a schema reference
...
This just helps keep an overall structure
2018-07-04 13:54:52 -06:00
Kitsune Ral
24afe7987c
Add operationId to all endpoints of all APIs
...
To facilitate generation of API stubs from the spec.
Signed-off-by: Alexey Rusakov <ktirf@users.sf.net>
2017-10-11 01:58:31 +09:00
Richard van der Hoff
820704a16a
Format examples as raw objects
...
According the the openapi spec, examples for responses and schemas should be
raw objects rather than being json strings. (It's unclear what non-json
examples should look like...).
The swagger UI used to support json strings, but no longer does. In short,
let's turn the json strings into their raw formats.
2017-09-27 08:04:24 +01:00
Richard van der Hoff
49cd65dd58
Add a license to the spec
...
We're licensing hte spec under ASLv2. Add the LICENSE file, and add the
short-form to as much of the source as is practical right now (adding it to
json source is a massive pita).
2016-07-12 17:28:30 +01:00
David Baker
e91214e78e
More links
...
Also remove now redundant anchor
2016-07-08 14:26:18 +01:00
David Baker
7c8651480a
Some PR feedback corrections
...
Including adding a hyperlink, although this requires a separate fix that I'll do on a different branch
2016-07-08 11:56:23 +01:00
David Baker
c109da5b78
Attempt to make things clearer
2016-07-07 17:07:38 +01:00
David Baker
86db820bb1
Expand on summaries for requestToken endpoints
2016-07-07 16:05:21 +01:00
David Baker
191cb08a3a
Add response section otherwise the checker fails
2016-07-07 15:00:27 +01:00
David Baker
d74a320edd
Stray tab
2016-07-07 14:58:05 +01:00
David Baker
ead5648b8c
Add requestToken endpoints
...
For password reset and 3pid adding
2016-07-07 14:52:45 +01:00
Richard van der Hoff
3bce28a15c
Clarifications to the 'Client authentication' section
...
* Use the terminology 'login type' everywhere instead of mixing up 'stage type'
and 'login type'
* Don't have a separate 'APIs using the User-Interactive Authentication
mechanism' section, because (a) it doesn't make much sense to organise the
APIs this way, and (b) it was a set of lies anyway.
* Move '/account/password' definition into registration.yaml so that register
and password can share a section in the spec; remove duplicate doc for
/password.
* Write some words on using 3pids for /login
2016-05-06 17:28:35 +01:00
Richard van der Hoff
9efd021f5e
Document the user-interactive api params
...
Document the parameters and responses on /register and /account/password which
are invoved in the user-interactive auth
2016-05-06 16:47:49 +01:00
Richard van der Hoff
23c4ffbc1b
Add securityDefintions to generated swagger JSON
...
Also factor out to a common file
2016-05-03 13:57:16 +01:00
Mark Haines
e7f80b7c71
Fix the key name to be three_pid_creds rather than threePidCreds
2016-01-29 13:00:59 +00:00
Daniel Wagner-Hall
1f5b6271f2
Generate swagger-ui output for client-server API
...
Depends on:
https://github.com/matrix-org/matrix-doc/pull/212
https://github.com/matrix-org/matrix-doc/pull/208
https://github.com/matrix-org/matrix-doc/pull/207
for the actual rendered output to not throw javascript errors at runtime.
2015-12-07 12:45:13 +00:00