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).
8 years ago
e91214e78e
More links
...
Also remove now redundant anchor
8 years ago
cf13c8997c
Merge branch 'dbkr/dont_line_wrap_rst' into dbkr/more_requesttokens
8 years ago
7c8651480a
Some PR feedback corrections
...
Including adding a hyperlink, although this requires a separate fix that I'll do on a different branch
8 years ago
19a59bc210
Merge pull request #345 from Ralith/require-prev_batch
...
Supply prev_batch unconditionally in timelines
8 years ago
c109da5b78
Attempt to make things clearer
8 years ago
86db820bb1
Expand on summaries for requestToken endpoints
8 years ago
191cb08a3a
Add response section otherwise the checker fails
8 years ago
d74a320edd
Stray tab
8 years ago
ead5648b8c
Add requestToken endpoints
...
For password reset and 3pid adding
8 years ago
ee5054fb42
Supply prev_batch unconditionally in timelines
...
Signed-off-by: Benjamin Saunders <ben.e.saunders@gmail.com>
8 years ago
14ff3862e3
More PR feedback
8 years ago
e4db7be8e2
Better structure for error response
...
& add server not trusted error
8 years ago
3dddc0dcdf
Explain why not erroring on dup 3pid is desireable
8 years ago
a600386c05
Consistent working for error response
...
Also format json example better
8 years ago
60293af83a
PR feedback
8 years ago
6a0c9edb49
Add the id_server param
8 years ago
b0194a3016
Spec for endpoint-specific 3pid verification token
...
As per proposal https://docs.google.com/document/d/13mapDbaOnbob9ZYRDiGm1YbeZhFOBj_R1OvgBA9pA5s/edit?pref=2&pli=1#
8 years ago
4f37e4ece0
Merge pull request #342 from matrix-org/erikj/presence
...
Fix and correctly document presence's currently_active
8 years ago
0de8ba7f0a
currently_active is a param on GET response, not put
8 years ago
30a3302921
Merge pull request #274 from matrix-org/markjh/default_rules
...
Update the predefined push rules in the spec
8 years ago
e80e32173f
Merge pull request #278 from matrix-org/erikj/presence
...
Update presence spec.
8 years ago
2691d4925b
s/currently_online/currently_active/
8 years ago
7bbb664784
Improve documentation of directory API
8 years ago
86a81b0450
Fix schema for /logout
...
'properties' is a map, not a list
8 years ago
e7e9f5fa46
Document the /logout api
...
We have one, and it's useful, so we really ought to document it
8 years ago
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
8 years ago
2093a6bac9
Merge pull request #332 from matrix-org/rav/update_login_api
...
Update the /login API spec
8 years ago
959f1ff09f
Update the /login API spec
...
Note that /login can be used with 3pid creds
8 years ago
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
8 years ago
2d28e5abce
Fix basePath on /redact API doc
8 years ago
432c78f3b5
Fix the swagger for /search so that it works without preprocessing
...
Makes the /search swagger work when it is imported directly into the swagger-UI
without preprocessing by dump_swagger
8 years ago
5383754a40
Access event-schemas via a symlink
...
Swagger gets a bit confused about $refs via '../..', so use a symlink to make
everything nicely relative.
8 years ago
1fe00b1517
Reinstate validator.js
...
It turns out that validator.js is used by the jenkins build script to, uh,
validate the docs.
This partially reverts commit affb106014
8 years ago
23c4ffbc1b
Add securityDefintions to generated swagger JSON
...
Also factor out to a common file
8 years ago
cf87120d78
Fixes to the API docs
...
* fix security data for DELETE /user/{userId}/rooms/{roomId}/tags/{tag}
* fix definition for body of PUT /pushrules/{scope}/{kind}/{ruleId}/actions
8 years ago
affb106014
Remove redundant scripts under api/
...
We now use newer swagger, via scripts/dump-swagger.py
8 years ago
1a856b53f3
Remove redundant info & add backticks
8 years ago
4b294b23de
Tailor descriptions to GET method
8 years ago
4fafe1ab73
Return an object as the root element
...
Because otherwise it's impossible to change later
8 years ago
42834340e7
Add title to the pushers array
8 years ago
0f6e414eb6
Fix format (array of objects, not object)
8 years ago
27113d71ff
Fix indentation
8 years ago
73d6e901ae
Add endpoint for getting a user's pushers
...
Also add profile_tag to the set docs as it was missing
8 years ago
c9ed063a36
Small copy paste error
...
'avatar url' should be 'profile information'
8 years ago
1d6c405f62
Fix presumably c+p fail
8 years ago
cf850b4270
Fix level of `counts` and `devices`
...
They are actually within the notification object rather than the top level object. Add titles to objects so it works.
8 years ago
89453bfd8c
Remove spurious blank line
8 years ago
64c6d30f90
hopefully fix rst
8 years ago
7faf2cf642
Paragraph breaks & missed word
8 years ago
Richard van der Hoff