darkkirb/akkoma
1
0
Fork 0
forked from mirrors/akkoma
Code Pull requests Activity

Add docs

Browse source
This commit is contained in:
Maxim Filippov 2019-03-02 17:32:46 +03:00
parent bf30df99cb
commit 08c6aeeed7
1 changed files with 31 additions and 18 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

19
docs/Admin-API.md
View file

@ -7,10 +7,16 @@ Authentication is required and the user must be an admin.
### List users ### List users
- Method `GET` - Method `GET`
- Params:
- `page`: **integer** page number
- `page_size`: **integer** number of users per page (default is `50`)
- Response: - Response:
```JSON ```JSON
[ {
"page_size": integer,
"count": integer,
"users": [
{ {
"deactivated": bool, "deactivated": bool,
"id": integer, "id": integer,
@ -18,9 +24,10 @@ Authentication is required and the user must be an admin.
}, },
... ...
] ]
}
``` ```
## `/api/pleroma/admin/users/search?query={query}&local={local}` ## `/api/pleroma/admin/users/search?query={query}&local={local}&page={page}&page_size={page_size}`
### Search users by name or nickname ### Search users by name or nickname
@ -28,10 +35,15 @@ Authentication is required and the user must be an admin.
- Params: - Params:
- `query`: **string** search term - `query`: **string** search term
- `local`: **bool** whether to return only local users - `local`: **bool** whether to return only local users
- `page`: **integer** page number
- `page_size`: **integer** number of users per page (default is `50`)
- Response: - Response:
```JSON ```JSON
[ {
"page_size": integer,
"count": integer,
"users": [
{ {
"deactivated": bool, "deactivated": bool,
"id": integer, "id": integer,
@ -39,6 +51,7 @@ Authentication is required and the user must be an admin.
}, },
... ...
] ]
}
``` ```
## `/api/pleroma/admin/user` ## `/api/pleroma/admin/user`