tsviewer/README.md

104 lines
1.9 KiB
Markdown

# tsviewer **[WIP]**
A TS3 Viewer with REST API.
## DOCKER-Config
```bash
docker build -t name/cont:ver .
docker run -e TS3_IP="0.0.0.0", TS3_PW="f3gWdOU3", WEB_PORT="8080" -d -p 8080:8080 name/cont:ver
```
ENV:
```Docker
ENV TS3_IP=0.0.0.0
ENV TS3_NICKNAME=serveradmin
ENV TS3_NAME=serveradmin
ENV TS3_PW=f3gWdOU3
ENV TS3_PORT=9987
ENV TS3_QUERY=10011
ENV WEB_PORT=8080
```
# Features
## Config
The config file is generated automatically on first startup.
```json
{
"user": {
"nickname": "serveradmin",
"name": "serveradmin",
"password": ""
},
"serverTS": {
"ip": "127.0.0.1",
"portServer": 9987,
"portQuery": 10011
},
"serverWeb": {
"port": 80
}
}
```
## URL-Parameter
| Name | Type | Description |
| ---------- | -------- | ------------------------ |
| `pretty` | `bool` | pretty-prints JSON |
| `envelope` | `bool` | wraps JSON in data array |
## Channels
- **`GET`** `/v1/channels/:id`
- **`GET`** `/v1/channels`
```json
{
"databaseId": 1,
"channelId": 1,
"nickname": "serveradmin from 127.0.0.1:58359",
"type": 1,
"away": false,
"awayMessage": ""
}
```
## Clients
- **`GET`** `/v1/clients/:id`
- **`GET`** `/v1/clients/`
```json
{
"id": 1,
"subchannels": [
... (contains all subchannel)
],
"name": "main1",
"totalClients": 0,
"neededSubscribePower": 0
}
```
## Server
- **`GET`** `/v1/server/info`
```json
{
"name": "TeamSpeak ]I[ Server",
"status": "online",
"version": "3.5.1 [Build: 1545076855]",
"welcomeMessage": "Welcome to TeamSpeak, check [URL]www.teamspeak.com[/URL] for latest information",
"maxClients": 32,
"clientsOnline": 2,
"reservedSlots": 0,
"uptime": 5976,
"totalPing": 0,
"minAndroidVersion": 1502275280,
"minClientVersion": 1513163251,
"miniOSVersion": 1502275280
}
```