# umbrello-api

Rest API for umbrello-bot.

The weather information is based on [OpenWeatherMap API](https://openweathermap.org/api).

**Technologies**:

- Node.js
- express
- mongodb

## Installation

1. Install `Node.js` and `npm`.
2. Install `mongodb`.
3. Clone this repository.
4. Install dependencies with `npm install`
5. Create env file or set environment variables. (read "Environment variables" paragraph)
6. Configure the list of city id (read "OpenWeatherMap - List Of City ID")
7. Build with `npm run build`.
8. Start the server with `npm run serve`.


### Environment Variables.
```
OWM_TOKEN=your-open-weather-map-token-api
OWM_LANG=en
OWM_UNITS=metric

TELEGRAM_TOKEN=your-telegram-bot-token

DB_HOST=mongodb://host:port/db
DB_USER=user
DB_PASSWORD=password
```

### OpenWeatherMap - List Of City ID

1. Download [city.list.min.json.gz](http://bulk.openweathermap.org/sample/city.list.min.json.gz)
2. Extract the json.
3. Import the json into MongoDB (collection: `umbrello_cities`).


## License
GPLv3

---
Made with ❤️ by Francesco Esposito ([@franjsco](https://github.com/franjsco))