Commit d74801ac authored by Rémy Coutable's avatar Rémy Coutable

Document the public Project API and document `GET /projects/:id/users`

Signed-off-by: default avatarRémy Coutable <remy@rymai.me>
parent 90c0f610
...@@ -347,7 +347,8 @@ Parameters: ...@@ -347,7 +347,8 @@ Parameters:
### Get single project ### Get single project
Get a specific project, identified by project ID or NAMESPACE/PROJECT_NAME, which is owned by the authenticated user. Get a specific project, identified by project ID or NAMESPACE/PROJECT_NAME, which is owned by the authenticated user.
If using namespaced projects call make sure that the NAMESPACE/PROJECT_NAME is URL-encoded, eg. `/api/v3/projects/diaspora%2Fdiaspora` (where `/` is represented by `%2F`). If using namespaced projects call make sure that the NAMESPACE/PROJECT_NAME is URL-encoded, eg. `/api/v3/projects/diaspora%2Fdiaspora` (where `/` is represented by `%2F`). This endpoint can be accessed without authentication if
the project is publicly accessible.
``` ```
GET /projects/:id GET /projects/:id
...@@ -436,10 +437,47 @@ Parameters: ...@@ -436,10 +437,47 @@ Parameters:
} }
``` ```
## Get project users
Get the users list of a project.
Parameters:
| Attribute | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `search` | string | no | Search for specific users |
```
GET /projects/:id/users
```
```json
[
{
"id": 1,
"username": "john_smith",
"name": "John Smith",
"state": "active",
"avatar_url": "http://localhost:3000/uploads/user/avatar/1/cd8.jpeg",
"web_url": "http://localhost:3000/john_smith"
},
{
"id": 2,
"username": "jack_smith",
"name": "Jack Smith",
"state": "blocked",
"avatar_url": "http://gravatar.com/../e32131cd8.jpeg",
"web_url": "http://localhost:3000/jack_smith"
}
]
```
### Get project events ### Get project events
Get the events for the specified project. Get the events for the specified project sorted from newest to oldest. This
Sorted from newest to oldest endpoint can be accessed without authentication if the project is publicly
accessible.
``` ```
GET /projects/:id/events GET /projects/:id/events
...@@ -1344,7 +1382,9 @@ Parameter: ...@@ -1344,7 +1382,9 @@ Parameter:
## Search for projects by name ## Search for projects by name
Search for projects by name which are accessible to the authenticated user. Search for projects by name which are accessible to the authenticated user. This
endpoint can be accessed without authentication if the project is publicly
accessible.
``` ```
GET /projects/search/:query GET /projects/search/:query
......
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