Giter Site home page Giter Site logo

abdelsalamshahlol / covid2019api Goto Github PK

View Code? Open in Web Editor NEW

This project forked from nat236919/covid19-api

0.0 1.0 0.0 149 KB

COVID-2019 API | CoronaVirus 2019 Global Cases

Home Page: https://covid2019-api.herokuapp.com/

License: MIT License

Dockerfile 0.86% Python 77.41% CSS 4.88% HTML 16.85%

covid2019api's Introduction

COVID2019-API

issues forks stars license

https://covid2019-api.herokuapp.com/

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).

References

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
docker-redis Docker + Redis + Web API For deploying to a server with Redis via docker-compose

Features

  1. The current data (daily updated)
  2. Confirmed, Deaths, Recovered
  3. The affected countries
  4. Individual affected country
  5. Timeseries

How to install (Docker-compose)

  • Run the following command in your command line to run the server
docker-compose up
  • Or run the server in the background
docker-compose up -d
  • The port can be changed at docker-compose.override.yml (currently set as 8000)
version: '3'
services:
  web:
    container_name: "covid19_api_web_container"
    volumes:
      - ./app:/app
    ports:
      - "8000:80"
    depends_on: 
      - redis
    environment:
      - "RUN=uvicorn main:app"
  
  redis:
    container_name: "covid19_api_redis_container"
    image: "redis"
    ports:
      - "6379:6379"

How to use API (v2)

Send a request to the follwing URLs:

Request (GET) Description
https://covid2019-api.herokuapp.com/v2/current Get all data from all the reportedly affected countries (List of Object)
https://covid2019-api.herokuapp.com/v2/total Get the total numbers of Confirmed, Deaths, and Recovered
https://covid2019-api.herokuapp.com/v2/confirmed Get the total number of Confirmed cases
https://covid2019-api.herokuapp.com/v2/deaths Get the total number of Deaths
https://covid2019-api.herokuapp.com/v2/recovered Get the total number of Recovered cases
https://covid2019-api.herokuapp.com/v2/active Get the total number of Active cases (Excluding Deaths and Recovered)
https://covid2019-api.herokuapp.com/v2/country/china Search a country by a key name (*space may be needed)
https://covid2019-api.herokuapp.com/v2/country/kr Search a country by an [ISO country code (alpha2)] (https://www.iban.com country-codes)
https://covid2019-api.herokuapp.com/v2/timeseries/global Get the time series: global
https://covid2019-api.herokuapp.com/v2/timeseries/{case} Get the time series: confirmed, deaths

Examples API (v2)

  1. Get current data
https://covid2019-api.herokuapp.com/v2/current
{"data": [{
      "location": "China",
      "confirmed": 81591,
      "deaths": 3281,
      "recovered": 73280,
      "active": 5030
    },
    {
      "location": "Italy",
      "confirmed": 69176,
      "deaths": 6820,
      "recovered": 8326,
      "active": 54030
    }.....n],
"dt": "2020-03-24 23:41:50",
"ts": 1585064510}
  1. Get total data
https://covid2019-api.herokuapp.com/v2/total
{
  "data": {
    "confirmed": 417966,
    "deaths": 18615,
    "recovered": 107705,
    "active": 236306
  },
  "dt": "2020-03-24 23:41:50",
  "ts": 1585064510
}
  1. Get confirmed cases
https://covid2019-api.herokuapp.com/v2/confirmed
{
  "data": 417966,
  "dt": "2020-03-24 23:41:50",
  "ts": 1585064510
}
  1. Get deaths
https://covid2019-api.herokuapp.com/v2/deaths
{
  "data": 18615,
  "dt": "2020-03-24 23:41:50",
  "ts": 1585064510
}
  1. Get recovered cases
https://covid2019-api.herokuapp.com/v2/recovered
{
  "data": 107705,
  "dt": "2020-03-24 23:41:50",
  "ts": 1585064510
}
  1. Get active cases
https://covid2019-api.herokuapp.com/v2/recovered
{
  "data": 236306,
  "dt": "2020-03-24 23:41:50",
  "ts": 1585064510
}
  1. Get a country data
https://covid2019-api.herokuapp.com/v2/country/th
{
  "data":{
    "location": "Thailand",
    "confirmed": 827,
    "deaths": 4,
    "recovered": 52,
    "active": 771
  },
  "dt": "2020-03-24 23:41:50",
  "ts": 1585064510
}

https://covid2019-api.herokuapp.com/v2/country/united%20kingdom
{
  "data":{
    "location": "United Kingdom",
    "confirmed": 8164,
    "deaths": 423,
    "recovered": 140,
    "active": 7601
  },
  "dt": "2020-03-24 23:41:50",
  "ts": 1585064510
}
  1. Get time series
https://covid2019-api.herokuapp.com/v2/timeseries/global
{
  "data": [
    {
      "1/22/20": {
        "confirmed": 555,
        "deaths": 17
      }
    },
    {
      "1/23/20": {
        "confirmed": 654,
        "deaths": 18
      }
    }...],
  "dt": "2020-03-25 23:37:49",
  "ts": 1585150669
}

https://covid2019-api.herokuapp.com/v2/timeseries/confirmed
{
  "data": [
    {
      "Province/State": "",
      "Country/Region": "Afghanistan",
      "Coordinates": {
        "Lat": 33,
        "Long": 65
      },
      "TimeSeries": [
        {
          "date": "1/22/20",
          "value": 0
        },
        {
          "date": "1/23/20",
          "value": 0
        }...]
    },
  "dt": "2020-03-25 23:37:49",
  "ts": 1585150669

How to use API (v1)

Send a request to the follwing URLs:

Request (GET) Description
https://covid2019-api.herokuapp.com/current Get all data from all the reportedly affected countries (Object)
https://covid2019-api.herokuapp.com/current_list Get all data from all the reportedly affected countries (List, Array)
https://covid2019-api.herokuapp.com/total Get the total numbers of Confirmed, Deaths, and Recovered
https://covid2019-api.herokuapp.com/confirmed Get the total number of Confirmed cases
https://covid2019-api.herokuapp.com/deaths Get the total number of Deaths
https://covid2019-api.herokuapp.com/recovered Get the total number of Recovered cases
https://covid2019-api.herokuapp.com/countries Get a list of the reportedly affected countries
https://covid2019-api.herokuapp.com/country/mainland_china Search a country by a key name (refered to 'current' method)
https://covid2019-api.herokuapp.com/country/kr Search a country by an [ISO country code (alpha2)] (https://www.iban.com/country-codes)
https://covid2019-api.herokuapp.com/timeseries/confirmed Get the time series - Confirmed
https://covid2019-api.herokuapp.com/timeseries/deaths Get the time series - Deaths
https://covid2019-api.herokuapp.com/timeseries/recovered Get the time series - Recovered

Examples API (v1)

  1. Get current data
https://covid2019-api.herokuapp.com/current
{"Mainland_China":{"confirmed":44641,"deaths":1113,"recovered":4730},"Thailand":{"confirmed":33,"deaths":0,"recovered":10},"Japan":{"confirmed":26,"deaths":0,"recovered":9},"South_Korea":{"confirmed":28,"deaths":0,"recovered":4},"Taiwan":{"confirmed":18,"deaths":0,"recovered":1},"US":{"confirmed":13,"deaths":0,"recovered":3},"Macau":{"confirmed":10,"deaths":0,"recovered":1},"Hong_Kong":{"confirmed":49,"deaths":1,"recovered":0},"Singapore":{"confirmed":47,"deaths":0,"recovered":9},"Vietnam":{"confirmed":15,"deaths":0,"recovered":6},"France":{"confirmed":11,"deaths":0,"recovered":0},"Nepal":{"confirmed":1,"deaths":0,"recovered":0},"Malaysia":{"confirmed":18,"deaths":0,"recovered":3},"Canada":{"confirmed":7,"deaths":0,"recovered":0},"Australia":{"confirmed":15,"deaths":0,"recovered":2},"Cambodia":{"confirmed":1,"deaths":0,"recovered":0},"Sri_Lanka":{"confirmed":1,"deaths":0,"recovered":1},"Germany":{"confirmed":16,"deaths":0,"recovered":0},"Finland":{"confirmed":1,"deaths":0,"recovered":1},"United_Arab_Emirates":{"confirmed":8,"deaths":0,"recovered":1},"Philippines":{"confirmed":3,"deaths":1,"recovered":0},"India":{"confirmed":3,"deaths":0,"recovered":0},"Italy":{"confirmed":3,"deaths":0,"recovered":0},"UK":{"confirmed":8,"deaths":0,"recovered":0},"Russia":{"confirmed":2,"deaths":0,"recovered":0},"Sweden":{"confirmed":1,"deaths":0,"recovered":0},"Spain":{"confirmed":2,"deaths":0,"recovered":0},"Belgium":{"confirmed":1,"deaths":0,"recovered":0},"Others":{"confirmed":135,"deaths":0,"recovered":0},"dt":"2/11/20 20:44","ts":1581425040.0}

https://covid2019-api.herokuapp.com/current_list
{"countries":[{"Mainland_China":{"confirmed":66292,"deaths":1520,"recovered":7973},"Thailand":{"confirmed":33,"deaths":0,"recovered":12},"Japan":{"confirmed":29,"deaths":1,"recovered":9},"South_Korea":{"confirmed":28,"deaths":0,"recovered":7},"Taiwan":{"confirmed":18,"deaths":0,"recovered":2},"US":{"confirmed":15,"deaths":0,"recovered":3},"Macau":{"confirmed":10,"deaths":0,"recovered":3},"Hong_Kong":{"confirmed":56,"deaths":1,"recovered":1},"Singapore":{"confirmed":67,"deaths":0,"recovered":17},"Vietnam":{"confirmed":16,"deaths":0,"recovered":7},"France":{"confirmed":11,"deaths":0,"recovered":2},"Nepal":{"confirmed":1,"deaths":0,"recovered":1},"Malaysia":{"confirmed":19,"deaths":0,"recovered":3},"Canada":{"confirmed":7,"deaths":0,"recovered":1},"Australia":{"confirmed":15,"deaths":0,"recovered":8},"Cambodia":{"confirmed":1,"deaths":0,"recovered":1},"Sri_Lanka":{"confirmed":1,"deaths":0,"recovered":1},"Germany":{"confirmed":16,"deaths":0,"recovered":1},"Finland":{"confirmed":1,"deaths":0,"recovered":1},"United_Arab_Emirates":{"confirmed":8,"deaths":0,"recovered":1},"Philippines":{"confirmed":3,"deaths":1,"recovered":1},"India":{"confirmed":3,"deaths":0,"recovered":0},"Italy":{"confirmed":3,"deaths":0,"recovered":0},"UK":{"confirmed":9,"deaths":0,"recovered":1},"Russia":{"confirmed":2,"deaths":0,"recovered":2},"Sweden":{"confirmed":1,"deaths":0,"recovered":0},"Spain":{"confirmed":2,"deaths":0,"recovered":0},"Belgium":{"confirmed":1,"deaths":0,"recovered":0},"Others":{"confirmed":218,"deaths":0,"recovered":0},"Egypt":{"confirmed":1,"deaths":0,"recovered":0}}],"dt":"2/14/20","ts":1581609600.0}
  1. Get total data
https://covid2019-api.herokuapp.com/total
{"confirmed":45117,"deaths":1115,"recovered":4781,"dt":"2/11/20 20:44","ts":1581425040.0}
  1. Get confirmed cases
https://covid2019-api.herokuapp.com/confirmed
{"confirmed":45117,"dt":"2/11/20 20:44","ts":1581425040.0}
  1. Get deaths
https://covid2019-api.herokuapp.com/deaths
{"deaths":1115,"dt":"2/11/20 20:44","ts":1581425040.0}
  1. Get recovered cases
https://covid2019-api.herokuapp.com/recovered
{"recovered":4781,"dt":"2/11/20 20:44","ts":1581425040.0}
  1. Get all the affected countries (Note: Others -> Diamond Princess cruise ship)
https://covid2019-api.herokuapp.com/countries
{"countries":["Mainland_China","Thailand","Japan","South_Korea","Taiwan","US","Macau","Hong_Kong","Singapore","Vietnam","France","Nepal","Malaysia","Canada","Australia","Cambodia","Sri_Lanka","Germany","Finland","United_Arab_Emirates","Philippines","India","Italy","UK","Russia","Sweden","Spain","Belgium","Others"],"dt":"2/11/20 20:44","ts":1581425040.0}
  1. Get a country by its key name (small letters) or ISO code (Alpha-2 code)
https://covid2019-api.herokuapp.com/country/mainland_china
{"Mainland_China":{"confirmed":44641,"deaths":1113,"recovered":4730},"dt":"2/11/20 20:44","ts":1581425040.0}

https://covid2019-api.herokuapp.com/country/cn
{"Mainland_China":{"confirmed":44641,"deaths":1113,"recovered":4730},"dt":"2/11/20 20:44","ts":1581425040.0}

https://covid2019-api.herokuapp.com/country/kr
{"South_Korea":{"confirmed":28,"deaths":0,"recovered":4},"dt":"2/11/20 20:44","ts":1581425040.0}
  1. Get a time series data from cases (confirmed, deaths, recovered)
https://covid2019-api.herokuapp.com/timeseries/confirmed
{"confirmed":[{"Province/State":"Anhui","Country/Region":"Mainland_China","Lat":"31.825709999999997","Long":"117.2264","1/21/20 22:00":"","1/22/20 12:00":"1.0","1/23/20 12:00":"9.0","1/24/20 0:00":"15.0","1/24/20 12:00":"15.0","1/25/20 0:00":"39.0","1/25/20 12:00":"39.0","1/25/20 22:00":"60.0","1/26/20 11:00":"60.0","1/26/20 23:00":"70.0","1/27/20 9:00":"70.0","1/27/20 19:00":"70.0","1/27/20 20:30":"106.0","1/28/20 13:00":"106.0","1/28/20 18:00":"106.0","1/28/20 23:00":"152.0","1/29/20 13:30":"152.0","1/29/20 14:30":"152.0","1/29/20 21:00":"200.0","1/30/20 11:00":"200.0","1/31/20 14:00":"237.0","2/1/20 10:00":"297.0","2/2/20 21:00":"408.0","2/3/20 21:00":"480.0","2/4/20 9:40":"480.0","2/4/20 22:00":"530.0","2/5/20 9:00":"530.0","2/5/20 23:00":"591.0","2/6/20 9:00":"591.0","2/6/20 14:20":"591.0","2/7/20 20:13":"665.0","2/7/20 22:50":"733.0","2/8/20 10:24":"733.0","2/8/20 23:04":"779.0","2/9/20 10:30":"779.0","2/9/20 23:20":"830.0","2/10/20 10:30":"830.0","2/10/20 19:30":"830.0","2/11/20 10:50":"860","2/11/20 20:44":"889","2/12/20 10:20":"889","2/12/20 22:00":"910"....n],"dt":"2/11/20 20:44","ts":1581425040.0}

https://covid2019-api.herokuapp.com/timeseries/deaths
{"deaths":[{"Province/State":"Anhui","Country/Region":"Mainland_China","Lat":"31.825709999999997","Long":"117.2264","1/21/20 22:00":"","1/22/20 12:00":"","1/23/20 12:00":"","1/24/20 0:00":"","1/24/20 12:00":"","1/25/20 0:00":"","1/25/20 12:00":"","1/25/20 22:00":"","1/26/20 11:00":"","1/26/20 23:00":"","1/27/20 9:00":"","1/27/20 19:00":"","1/27/20 20:30":"","1/28/20 13:00":"","1/28/20 18:00":"","1/28/20 23:00":"","1/29/20 13:30":"","1/29/20 14:30":"","1/29/20 21:00":"","1/30/20 11:00":"","1/31/20 14:00":"","2/1/20 10:00":"","2/2/20 21:00":"","2/3/20 21:00":"","2/4/20 9:40":"","2/4/20 22:00":"","2/5/20 9:00":"","2/5/20 23:00":"","2/6/20 9:00":"","2/6/20 14:20":"","2/7/20 20:13":"","2/7/20 22:50":"","2/8/20 10:24":"0.0","2/8/20 23:04":"1.0","2/9/20 10:30":"1.0","2/9/20 23:20":"3.0","2/10/20 10:30":"3.0","2/10/20 19:30":"3.0","2/11/20 10:50":"4","2/11/20 20:44":"4","2/12/20 10:20":"4","2/12/20 22:00":"5"...n],"dt":"2/11/20 20:44","ts":1581425040.0}

https://covid2019-api.herokuapp.com/timeseries/recovered
{"recovered":[{"Province/State":"Anhui","Country/Region":"Mainland_China","Lat":"31.825709999999997","Long":"117.2264","1/21/20 22:00":"","1/22/20 12:00":"","1/23/20 12:00":"","1/24/20 0:00":"","1/24/20 12:00":"","1/25/20 0:00":"","1/25/20 12:00":"","1/25/20 22:00":"","1/26/20 11:00":"","1/26/20 23:00":"","1/27/20 9:00":"","1/27/20 19:00":"","1/27/20 20:30":"","1/28/20 13:00":"","1/28/20 18:00":"","1/28/20 23:00":"","1/29/20 13:30":"2.0","1/29/20 14:30":"2.0","1/29/20 21:00":"2.0","1/30/20 11:00":"2.0","1/31/20 14:00":"3.0","2/1/20 10:00":"5.0","2/2/20 21:00":"7.0","2/3/20 21:00":"14.0","2/4/20 9:40":"14.0","2/4/20 22:00":"20.0","2/5/20 9:00":"23.0","2/5/20 23:00":"23.0","2/6/20 9:00":"34.0","2/6/20 14:20":"34.0","2/7/20 20:13":"47.0","2/7/20 22:50":"47.0","2/8/20 10:24":"59.0","2/8/20 23:04":"59.0","2/9/20 10:30":"72.0","2/9/20 23:20":"73.0","2/10/20 10:30":"88.0","2/10/20 19:30":"88.0","2/11/20 10:50":"105","2/11/20 20:44":"108","2/12/20 10:20":"127","2/12/20 22:00":"128".....n],"dt":"2/11/20 20:44","ts":1581425040.0}

covid2019api's People

Contributors

jhert0 avatar nat236919 avatar soapy1 avatar timweissenfels avatar

Watchers

avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.