https://github.com/akshayitzme/cowinalerter-node

Heroku Ready to Deploy Express.js app to check Slot Availability every 15 secs, sends telegram alerts when there is a Slot Available.
https://github.com/akshayitzme/cowinalerter-node

cowin cowin-alerts express heroku nodejs telegram vaccine

Last synced: about 14 hours ago
JSON representation

Heroku Ready to Deploy Express.js app to check Slot Availability every 15 secs, sends telegram alerts when there is a Slot Available.

• Host: GitHub
• URL: https://github.com/akshayitzme/cowinalerter-node
• Owner: akshayitzme
• License: mit
• Created: 2021-07-17T15:43:57.000Z (over 3 years ago)
• Default Branch: master
• Last Pushed: 2024-09-17T07:13:35.000Z (2 months ago)
• Last Synced: 2024-09-18T07:40:21.154Z (2 months ago)
• Topics: cowin, cowin-alerts, express, heroku, nodejs, telegram, vaccine
• Language: JavaScript
• Homepage:
• Size: 89.8 KB
• Stars: 1
• Watchers: 1
• Forks: 1
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# CowinAlerter-Node 



![contributions welcome](https://img.shields.io/badge/contributions-welcome-brightgreen.svg?style=for-the-badge) 

![GitHub top language](https://img.shields.io/github/languages/top/akshayitzme/cowinAlerter-node?style=for-the-badge)

![Lines of code](https://img.shields.io/tokei/lines/github/akshayitzme/cowinAlerter-node?style=for-the-badge)

[![Deploy](https://www.herokucdn.com/deploy/button.svg)](https://heroku.com/deploy?template=https://github.com/akshayitzme/cowinAlerter-node)

Automatically checks for available slots every 15 seconds, sends Alerts via Telegram. 

## Features

- Heroku Ready.

- Checks Slot Availability of 5 days.

- Supports  Finding Slots by Pin Code & District Code.

- Personalized Alerts.. Alerts based on Users Age Group, Dose, FirstDose..etc

- Checks Slot Availability in background.

## Set Up

### Heroku

- Fork this Repository

- Add Users in *[Users.json](/Database/Users.json)*

	refer this [gist](https://gist.github.com/akshayitzme/57f4c1cba4d3a22f4f2e145b94a225e1)

- Connect Forked GitHub repo to Heroku.

- Set Telegram Bot Id in Heroku Config Vars. *[see guide](https://devcenter.heroku.com/articles/config-vars)* also see *[env.example](env.example)*

- Add NodeJs Buildpack.

- Deploy App

### LocalHost 

- Clone this Repository

- Add Users in *[Users.json](/Database/Users.json)*

	refer this [gist](https://gist.github.com/akshayitzme/57f4c1cba4d3a22f4f2e145b94a225e1)

- Set Telegram Bot Id in `.env` file.  see *[env.example](env.example)*

- Install Dependencies

	 `yarn install`  or  `npm i`

- Run Server

	```bash 

	node index

	```

**Works well in all other Hosting Platforms.**

## Notes

- to find district ID, use this [API](https://apisetu.gov.in/public/marketplace/api/cowin#/Metadata%20APIs/districts)

## References

[APISetu](https://apisetu.gov.in/public/marketplace/api/cowin#/)

## Licence

![GitHub](https://img.shields.io/github/license/akshayitzme/cowinAlerter-node?style=for-the-badge)