Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/nat236919/covid19-api
API for exploring COVID-19 cases around the globe
https://github.com/nat236919/covid19-api
api coronavirus coronavirus-tracking covid-19 covid19 hacktoberfest python
Last synced: about 2 months ago
JSON representation
API for exploring COVID-19 cases around the globe
- Host: GitHub
- URL: https://github.com/nat236919/covid19-api
- Owner: nat236919
- License: mit
- Created: 2020-02-09T11:35:50.000Z (over 4 years ago)
- Default Branch: development
- Last Pushed: 2024-04-17T01:09:08.000Z (5 months ago)
- Last Synced: 2024-07-27T22:44:03.950Z (about 2 months ago)
- Topics: api, coronavirus, coronavirus-tracking, covid-19, covid19, hacktoberfest, python
- Language: Python
- Homepage: https://nuttaphat.com/covid19-api/
- Size: 893 KB
- Stars: 119
- Watchers: 5
- Forks: 63
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
Awesome Lists containing this project
README
API for exploring covid-19 cases around the globe powered by FastAPI framework
# Introduction
This API provides the information regarding '2019 Novel Coronavirus (covid-19)'. It contains a number of confirmed, death, and recovered cases based on the data provided by the Johns Hopkins University Center for Systems Science and Engineering (JHU CSSE).
## Example
- https://covid19api.azurewebsites.net/
- https://covid2019-api.herokuapp.com/
## Applications
- [Coronavirus App by YaseenAbdullah](https://github.com/YaseenAbdullah/coronavirus)
- [Covid 19 App - Map, info & help by DavidBarbaran](https://github.com/DavidBarbaran/Covid19App)
- [COVID-19 Visual Explorer by FitnessAI](https://www.fitnessai.com/covid-19-charts-coronavirus-growth-rate-visual-explorer)
- [BAILAM (Data and API Integration)](https://www.bailam.com/covid19)
- [Coronavirus Tech Handbook (Data Tools)](https://coronavirustechhandbook.com/data-tools)
### Reference
- https://github.com/CSSEGISandData/COVID-19
## Branches
| Branch | Feature | Description |
| ----------- | ---------------- | ------------------------------------ |
| master | Docker + Web API | For deploying to a server |
| development | Docker + Web API | For testing before merging to Master |
## Features
1. The current data (daily updated)
2. Confirmed, Deaths, Recovered
3. The affected countries
4. Individual affected country
5. Timeseries
## How to Start a Server
- Go to **app** directory and Run the following command in your command line to start a server
```console
uvicorn main:app
```
## How to install (Docker-compose)
- Run the following command in your command line to run the server
```console
docker-compose up
```
- Or run the server in the background
```console
docker-compose up -d
```
- The port can be changed at docker-compose.override.yml
```yml
version: "3"
services:
web:
container_name: "covid19_api_web_container"
volumes:
- ./app:/app
ports:
- "80:80"
environment:
- "RUN=uvicorn main:app"
```
## How to install (from Dockerhub)
- Download the latest image
```console
docker pull nat236919/covid19-api:latest
```
- Create a container and run
```console
docker run nat236919/covid19-api
```
## How to use API (v2)
Check it out [here](./app/docs/api_docs/v2.md)
## How to use API (v1)
Check it out [here](./app/docs/api_docs/v1.md)
## Contributors ✨
Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):
Nuttaphat Arunoprayoch
🚧 💻 🐛 📖 👀
Sophia Castellarin
💻
Jeremy
💻
Tim
🌍
melsaa
💻
owen-duncan-snobel
💻 📖 💵
Maria Sitkovets
💻
Ali Raeisdanaei
💻
This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome!
## Sponsor this project
