Commit 97ea04124693c271e060e4697d2d7cfbaadbae4a
Exists in
master
and in
4 other branches
Merge pull request #1233 from robbytaylor/master
Changes to text in API documentation
Showing
2 changed files
with
9 additions
and
11 deletions
Show diff stats
doc/api/README.md
| 1 | 1 | # Gitlab API |
| 2 | 2 | |
| 3 | -All API requests require authentication. You need to pass `private_token` parameter to authenticate. | |
| 3 | +All API requests require authentication. You need to pass a `private_token` parameter to authenticate. You can find or reset your private token in your profile. | |
| 4 | 4 | |
| 5 | -To get or reset your token visit your profile. | |
| 6 | - | |
| 7 | -If no or invalid `private_token` provided error message will be returned with status code 401: | |
| 5 | +If no, or an invalid, `private_token` is provided then an error message will be returned with status code 401: | |
| 8 | 6 | |
| 9 | 7 | ```json |
| 10 | 8 | { |
| ... | ... | @@ -12,10 +10,9 @@ If no or invalid `private_token` provided error message will be returned with st |
| 12 | 10 | } |
| 13 | 11 | ``` |
| 14 | 12 | |
| 15 | -API requests should be prefixed with `api` and the API version. | |
| 16 | -API version is equal to Gitlab major version number and defined in `lib/api.rb`. | |
| 13 | +API requests should be prefixed with `api` and the API version. The API version is equal to the Gitlab major version number, which is defined in `lib/api.rb`. | |
| 17 | 14 | |
| 18 | -Example of valid API request: | |
| 15 | +Example of a valid API request: | |
| 19 | 16 | |
| 20 | 17 | ``` |
| 21 | 18 | GET http://example.com/api/v2/projects?private_token=QVy1PB7sTxfy4pqfZM1U | ... | ... |
doc/api/projects.md
| 1 | 1 | ## List projects |
| 2 | 2 | |
| 3 | -Get a list of authenticated user's projects. | |
| 3 | +Get a list of projects owned by the authenticated user. | |
| 4 | 4 | |
| 5 | 5 | ``` |
| 6 | 6 | GET /projects |
| ... | ... | @@ -55,7 +55,7 @@ GET /projects |
| 55 | 55 | |
| 56 | 56 | ## Single project |
| 57 | 57 | |
| 58 | -Get an authenticated user's project. | |
| 58 | +Get a specific project, identified by project ID, which is owned by the authentication user. | |
| 59 | 59 | |
| 60 | 60 | ``` |
| 61 | 61 | GET /projects/:id |
| ... | ... | @@ -109,7 +109,7 @@ found` on fail. |
| 109 | 109 | |
| 110 | 110 | ## Project repository branches |
| 111 | 111 | |
| 112 | -Get a list of project repository branches sorted by name alphabetically. | |
| 112 | +Get a list of repository branches from a project, sorted by name alphabetically. | |
| 113 | 113 | |
| 114 | 114 | ``` |
| 115 | 115 | GET /projects/:id/repository/branches |
| ... | ... | @@ -186,7 +186,7 @@ Parameters: |
| 186 | 186 | |
| 187 | 187 | ## Project repository tags |
| 188 | 188 | |
| 189 | -Get a list of project repository tags sorted by name in reverse alphabetical order. | |
| 189 | +Get a list of repository tags from a project, sorted by name in reverse alphabetical order. | |
| 190 | 190 | |
| 191 | 191 | ``` |
| 192 | 192 | GET /projects/:id/repository/tags |
| ... | ... | @@ -237,3 +237,4 @@ Parameters: |
| 237 | 237 | + `filepath` (required) - The path the file |
| 238 | 238 | |
| 239 | 239 | Will return the raw file contents. |
| 240 | + | ... | ... |