byteschneiderei/medium-rss-api repository overview
Medium RSS API
A REST API wrapper for Medium RSS Feed with built in cache mechanism and HTML Tokenizer that parses Medium's plain HTML string into DOM objects. Just set your medium's user profile name or publication and you're good to go!
Built and tested using Golang v1.14.4.
Configuration
There are some configurations which takes place in environment variable that needed to be setup first before you can start using the API which are:
| Name | Mandatory | Default | Description |
|---|---|---|---|
| MEDIUM_PROFILE | Y | - | User or publication name |
| MEDIUM_RSSFEED_URL | N | https://medium.com/feed | Medium's feed base url |
| BASE_URL | N | localhost | Host of the REST API server |
| PORT | N | 8080 | Port of the REST API server |
| GO_ENV | N | development | Environment stage |
Build
To build, simply clone this repository and run
make build
Developing
You can run watcher.sh to run the server and re-build automatically everytime the go file changes.
Installation & Usage
To install simply pull the docker image.
Endpoints
Currently, available endpoints are :
/version - to check the application version
/health - to check the application health
/medium - to get the medium's RSS feed
Contributors ✨
Thanks goes to these wonderful people (emoji key):
This project follows the all-contributors specification. Contributions of any kind welcome!
License
MIT License. Copyright (c) 2020 ByteSchneiderei GmbH
Tag summary
Content type
Image
Digest
sha256:37a37251f…
Size
6.8 MB
Last updated
over 3 years ago
docker pull byteschneiderei/medium-rss-api