start of api docs

This commit is contained in:
gempir 2017-04-26 19:45:59 +02:00
parent 02e84bc1d1
commit 99b197d7a2

View file

@ -4,5 +4,68 @@
gempbot is a bot I maintain for a couple of channels. It's features differ from other bots in that it doesn't support
commands etc. yet, it focuses on logging and providing an api for the logs.
#### Usage
You need glide to install the dependencies and you should study the config.json.example if you want to run your own bot
##API
**Root Domain** `https://api.gempir.com`
##### All Requests only with HTTPS!
#### RandomQuote
Responds with a random message from the give user in that channel.
* **URL** `/channel/%channel%/user/%username%/random`
* **Methods** `GET`
* **Parameter**
- `%channel%` Channel from which you want the quote
- `%username%` Username from whom you want the quote
* **Success Response**
* **Code:** 200
**Content:** `gempir: My Random Message`
* **Error Response:** `{"Error":"error finding logs"}`
- **Notice**
With the Header Content-Type: "application/json" the response will be in json format. Example:
`{
"channel": "gempbot",
"username": "gempir",
"message": "MingLee",
"timestamp": "2017-03-12 09:43:22"
}`
#### Userlog
Responds with the timestamped log of a user in the current month for the given channel.
* **URL** `/channel/%channel%/user/%username%`
* **Methods** `GET`
* **Parameter**
- `%channel%` Channel that the user wrote in
- `%username%` Username that typed in the chat
* **Success Response**
* **Code:** 200
**Content:**
[2017-04-1 06:40:24] gempir: HaHaa
[2017-04-1 06:40:36] gempir: KKona
[2017-04-1 06:40:43] gempir: NaM
* **Error Response:** `{"message":"Not Found"}`
* **Notice**
This endpoint will redirect to the current Month and Year so the url will say `/channel/%channel%/user/%username%/2017/April`