58 lines
792 B
Markdown
58 lines
792 B
Markdown
|
# Users API
|
||
|
|
|
||
|
|
## Get users list [GET /v3/users]
|
||
|
|
> Get users list
|
||
|
|
|
||
|
|
### Request
|
||
|
|
* Policy: read_users
|
||
|
|
* Method: GET
|
||
|
|
* Headers:
|
||
|
|
- Accept: application/json
|
||
|
|
|
||
|
|
### Response
|
||
|
|
**Status: 200**
|
||
|
|
* Headers:
|
||
|
|
- Content-Type: application/json
|
||
|
|
* Body:
|
||
|
|
```json
|
||
|
|
[
|
||
|
|
{
|
||
|
|
"id": "user id",
|
||
|
|
"email": "user email",
|
||
|
|
"roles": []
|
||
|
|
}
|
||
|
|
]
|
||
|
|
```
|
||
|
|
|
||
|
|
## Create user [POST /v3/user]
|
||
|
|
> Create new user
|
||
|
|
|
||
|
|
### Request
|
||
|
|
* Policy: create_users
|
||
|
|
* Method: POST
|
||
|
|
* Headers:
|
||
|
|
- Accept: application/json
|
||
|
|
- Content-Type: application/json
|
||
|
|
* Body
|
||
|
|
```json
|
||
|
|
{
|
||
|
|
"id": "user id",
|
||
|
|
"password": "user password",
|
||
|
|
"email": "user email",
|
||
|
|
"roles": []
|
||
|
|
}
|
||
|
|
```
|
||
|
|
|
||
|
|
### Response
|
||
|
|
**Status: 201**
|
||
|
|
* Headers:
|
||
|
|
- Content-Type: application/json
|
||
|
|
* Body:
|
||
|
|
```json
|
||
|
|
{
|
||
|
|
"id": "user id",
|
||
|
|
"message": "Created"
|
||
|
|
}
|
||
|
|
```
|
||
|
|
|