Commit da040fc1348eb7747dd18084a2b12967f7c2b759
1 parent
beb00af0
Exists in
master
and in
4 other branches
API documentation expanded with status code information
Information to return codes added to projects and users documentation.
Showing
2 changed files
with
18 additions
and
0 deletions
Show diff stats
doc/api/projects.md
| @@ -57,6 +57,11 @@ GET /projects | @@ -57,6 +57,11 @@ GET /projects | ||
| 57 | ] | 57 | ] |
| 58 | ``` | 58 | ``` |
| 59 | 59 | ||
| 60 | +Return values: | ||
| 61 | + | ||
| 62 | ++ `200 Ok` on success and a list of projects | ||
| 63 | ++ `401 Unauthorized` if the user is not allowed to access projects | ||
| 64 | + | ||
| 60 | 65 | ||
| 61 | ### Get single project | 66 | ### Get single project |
| 62 | 67 |
doc/api/users.md
| @@ -43,6 +43,12 @@ GET /users | @@ -43,6 +43,12 @@ GET /users | ||
| 43 | ] | 43 | ] |
| 44 | ``` | 44 | ``` |
| 45 | 45 | ||
| 46 | +Return values: | ||
| 47 | + | ||
| 48 | ++ `200 Ok` on success and a list with all users | ||
| 49 | ++ `401 Unauthorized` if user is not allowed to access the list | ||
| 50 | + | ||
| 51 | + | ||
| 46 | ## Single user | 52 | ## Single user |
| 47 | 53 | ||
| 48 | Get a single user. | 54 | Get a single user. |
| @@ -74,6 +80,13 @@ Parameters: | @@ -74,6 +80,13 @@ Parameters: | ||
| 74 | } | 80 | } |
| 75 | ``` | 81 | ``` |
| 76 | 82 | ||
| 83 | +Return values: | ||
| 84 | + | ||
| 85 | ++ `200 Ok` on success and the user entry | ||
| 86 | ++ `401 Unauthorized` if it is not allowed to access the user | ||
| 87 | ++ `404 Not Found` if the user with ID is not found | ||
| 88 | + | ||
| 89 | + | ||
| 77 | ## User creation | 90 | ## User creation |
| 78 | Create user. Available only for admin | 91 | Create user. Available only for admin |
| 79 | 92 |