WebAPI - MazeXD/cuwo GitHub Wiki
##Features
- List online players
- Get details of a specific player (level, skills, equipment, ...)
- Kick players
- Get/Set ingame time
- Send a global message
- Send a message to a specific player
##Configuration
Setting Type | Setting | Description |
---|---|---|
int | webapi_port | Port WebAPI is running on |
string[] | webapi_keys | Keys which are allowed to access WebAPI |
##Usage
The base endpoint is http://{Address of cuwo host}:{webapi_port}/
.
Each request requires a valid key!
Each response is json formatted.
Example
Request:
http://127.0.0.1:12350/player/?key=w4b341g6184e9rg
Response:{"players": [{"name": "MazeXD", "id": 1}, {"name": "Xharon", "id": 2}]}
##Endpoints
Endpoint | Method | Description | Extra |
---|---|---|---|
/ | GET | Returns version of WebAPI | |
/status/ | GET | Returns (seed, players, limit) | |
/player/ | GET | Returns list of players with IDs | |
/player/{name}/ | GET | Return details about a player | append &include={inclusion} inclusion supports skills, equipment e.g. skills or skills,equipment |
/kick/{name}/ | GET | Kicks the player | |
/time/ | GET | Returns ingame time | |
/time/{time}/ | GET | Sets ingame time | {time} must match the time format %H:%M (eg. 13:43) |
/message/ | POST | Sends post data as global message | |
/message/{name}/ | POST | Sends post data to player |
##Error Codes
Code | Meaning |
---|---|
-1 | UNAUTHORIZED |
-2 | INVALID_RESOURCE |
-3 | INVALID_PLAYER |
-4 | INVALID_TIME |
-5 | INVALID_METHOD |
SDKs
Language | Link |
---|---|
Python | https://github.com/MazeXD/cuwo/blob/feature-webapi/webapi-sdk/python/webapi.py |
PHP | https://github.com/MazeXD/cuwo/blob/feature-webapi/webapi-sdk/php/webapi.php |