freechat/docs/content/endpoints/members.md
shockrah ba7b33ae62 Fixed broken links for messages endpoint description
 Should probably have a section for messages under structures
2021-03-04 13:21:09 -08:00

72 lines
960 B
Markdown

---
title: Members
anchor: members-ep
weight: 14
---
### `POST /members/me/nickname`
* Required permissions:
* CHANGE_NICK
* Required query string parameters:
* id: u64
* jwt: String
* name: String
* New nickname to change to(if allowed)
* Returns
* None
### `GET /members/me`
* Required query string parameters:
* id: u64
* jwt: String
* Returns:
* Member
* Contains all public data about your account on the server
Example
```
> GET /members/me?id=123&jwt=...
< {
< "name": "nickname-here",
< "id": 123,
< "joindate": <unix-timestamp>,
< "permissions": <64-bit-mask>
< }
```
### `GET /members/online`
* Required query string parameters:
* id: u64
* jwt: String
* limit: Optional<u64>
* Internal default: 100
* Returns
* members: Array<Members>
* Each member contains: [`name`, `id`, `joindate`, `permissions`]
* count: u64
Example
```
> GET /members/online?id=123&jwt=...
< { "members": [...] }
```