moviequotebot-api/README.md
Louis Vallat 58f6ddf215 Added some info in README
Signed-off-by: Louis Vallat <louis@louis-vallat.xyz>
2021-06-09 16:23:48 +02:00

36 lines
1.0 KiB
Markdown

# MovieQuoteBot API
A simple API written in Rust for MovieQuoteBot that returns JSON data via HTTP.
> This API is in an unstable state: it will surely change a lot.
The data Structures are like:
![this image describing the data Structures in MoviesQuoteBot's database](https://gitlab.com/lovallat/moviesquotebot/-/raw/master/DatabaseSchema.png)
Except the user ids that have been redacted and removed from the API.
## Endpoints
## Health
You can query `/health` and if `Healthy` is returned, the API is alive.
### V1
#### List subtitles
You can use `/v1/subtitles/list` to list subtitles stored in database.
##### Structure
- `subtitles`: all subtitles stored in database
- `films`: the films associated with these subtitles, linked by their id: `subtitles.film_id` -> `films.id`
- `languages`: the languages associated with these subtitles, linked by their id: `subtitles.language_id` -> `languages.id`
The time is represented using the UTC Timezone.
#### List subtitles
You can use `/v1/languages/list` to list languages stored in database.