Commit c50f8951 authored by Dmitriy Zaporozhets's avatar Dmitriy Zaporozhets

Merge pull request #7196 from cirosantilli/patch-2

Enforce md style.
parents 25c9bf4b a6e3b780
...@@ -6,7 +6,7 @@ Get a list of users. ...@@ -6,7 +6,7 @@ Get a list of users.
This function takes pagination parameters `page` and `per_page` to restrict the list of users. This function takes pagination parameters `page` and `per_page` to restrict the list of users.
### For normal users: ### For normal users
``` ```
GET /users GET /users
...@@ -31,8 +31,7 @@ GET /users ...@@ -31,8 +31,7 @@ GET /users
] ]
``` ```
### For admins
### For admins:
``` ```
GET /users GET /users
...@@ -92,7 +91,7 @@ Also see `def search query` in `app/models/user.rb`. ...@@ -92,7 +91,7 @@ Also see `def search query` in `app/models/user.rb`.
Get a single user. Get a single user.
#### For user: ### For user
``` ```
GET /users/:id GET /users/:id
...@@ -112,8 +111,7 @@ Parameters: ...@@ -112,8 +111,7 @@ Parameters:
} }
``` ```
### For admin
#### For admin:
``` ```
GET /users/:id GET /users/:id
...@@ -161,13 +159,13 @@ Parameters: ...@@ -161,13 +159,13 @@ Parameters:
- `username` (required) - Username - `username` (required) - Username
- `name` (required) - Name - `name` (required) - Name
- `skype` (optional) - Skype ID - `skype` (optional) - Skype ID
- `linkedin` (optional) - Linkedin - `linkedin` (optional) - LinkedIn
- `twitter` (optional) - Twitter account - `twitter` (optional) - Twitter account
- `website_url` (optional) - Website url - `website_url` (optional) - Website URL
- `projects_limit` (optional) - Number of projects user can create - `projects_limit` (optional) - Number of projects user can create
- `extern_uid` (optional) - External UID - `extern_uid` (optional) - External UID
- `provider` (optional) - External provider name - `provider` (optional) - External provider name
- `bio` (optional) - User's bio - `bio` (optional) - User's biography
- `admin` (optional) - User is admin - true or false (default) - `admin` (optional) - User is admin - true or false (default)
- `can_create_group` (optional) - User can create groups - true or false - `can_create_group` (optional) - User can create groups - true or false
...@@ -181,26 +179,32 @@ PUT /users/:id ...@@ -181,26 +179,32 @@ PUT /users/:id
Parameters: Parameters:
- `email` - Email - `email` - Email
- `username` - Username - `username` - Username
- `name` - Name - `name` - Name
- `password` - Password - `password` - Password
- `skype` - Skype ID - `skype` - Skype ID
- `linkedin` - Linkedin - `linkedin` - LinkedIn
- `twitter` - Twitter account - `twitter` - Twitter account
- `website_url` - Website url - `website_url` - Website URL
- `projects_limit` - Limit projects each user can create - `projects_limit` - Limit projects each user can create
- `extern_uid` - External UID - `extern_uid` - External UID
- `provider` - External provider name - `provider` - External provider name
- `bio` - User's bio - `bio` - User's biography
- `admin` (optional) - User is admin - true or false (default) - `admin` (optional) - User is admin - true or false (default)
- `can_create_group` (optional) - User can create groups - true or false - `can_create_group` (optional) - User can create groups - true or false
Note, at the moment this method does only return a 404 error, even in cases where a 409 (Conflict) would be more appropriate, e.g. when renaming the email address to some existing one. Note, at the moment this method does only return a 404 error,
even in cases where a 409 (Conflict) would be more appropriate,
e.g. when renaming the email address to some existing one.
## User deletion ## User deletion
Deletes a user. Available only for administrators. This is an idempotent function, calling this function for a non-existent user id still returns a status code `200 Ok`. The JSON response differs if the user was actually deleted or not. In the former the user is returned and in the latter not. Deletes a user. Available only for administrators.
This is an idempotent function, calling this function for a non-existent user id
still returns a status code `200 Ok`.
The JSON response differs if the user was actually deleted or not.
In the former the user is returned and in the latter not.
``` ```
DELETE /users/:id DELETE /users/:id
...@@ -310,7 +314,7 @@ POST /user/keys ...@@ -310,7 +314,7 @@ POST /user/keys
Parameters: Parameters:
- `title` (required) - new SSH Key's title - `title` (required) - new SSH Key's title
- `key` (required) - new SSH key - `key` (required) - new SSH key
## Add SSH key for user ## Add SSH key for user
...@@ -322,15 +326,17 @@ POST /users/:id/keys ...@@ -322,15 +326,17 @@ POST /users/:id/keys
Parameters: Parameters:
- `id` (required) - id of specified user - `id` (required) - id of specified user
- `title` (required) - new SSH Key's title - `title` (required) - new SSH Key's title
- `key` (required) - new SSH key - `key` (required) - new SSH key
Will return created key with status `201 Created` on success, or `404 Not found` on fail. Will return created key with status `201 Created` on success, or `404 Not found` on fail.
## Delete SSH key for current user ## Delete SSH key for current user
Deletes key owned by currently authenticated user. This is an idempotent function and calling it on a key that is already deleted or not available results in `200 Ok`. Deletes key owned by currently authenticated user.
This is an idempotent function and calling it on a key that is already deleted
or not available results in `200 Ok`.
``` ```
DELETE /user/keys/:id DELETE /user/keys/:id
...@@ -351,6 +357,6 @@ DELETE /users/:uid/keys/:id ...@@ -351,6 +357,6 @@ DELETE /users/:uid/keys/:id
Parameters: Parameters:
- `uid` (required) - id of specified user - `uid` (required) - id of specified user
- `id` (required) - SSH key ID - `id` (required) - SSH key ID
Will return `200 Ok` on success, or `404 Not found` if either user or key cannot be found. Will return `200 Ok` on success, or `404 Not found` if either user or key cannot be found.
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment