README.md

Unofficial API Covid-19 Kabupaten Dairi

---

Selamat datang di repository Unofficial API Covid-19 Kabupaten Dairi yang dibuat untuk memudahkan pengembangan perangkat lunak bagi pengembang-pengembang aplikasi penyebaran Covid-19 terkhususnya di Kabupaten Dairi.

Host Utama

https://covid-dairi.oliak.studio/

Host Alternatif

https://dairi-covid-api.vercel.app/

Dokumentasi ini dibuat untuk memandu penggunaan restful API Covid-19 Kabupaten Dairi ini. Dokumentasi ini memandu dengan menggunakan Host Utama, tidak perlu khawatir apabila Host Utama mengalami down, kamu bisa menggunakan Host Alternatif secara teknis restful API baik Host Utama maupun Host Alternatif adalah sama.

Penggunaan

Sebelum masuk ke dalam penggunaan restful API kamu bisa menggunakan alat-alat yang biasa kamu gunakan untuk melakukan fetching data terhadap restful API dan pada dokumentasi ini kita akan menggunakan curl.

Mari kita coba dengan request ke https://covid-dairi.oliak.studio/

# request
curl https://covid-dairi.oliak.studio/

# response
{
    "status": "ok",
    "code": 200,
    "message": "success",
    "documentation": "https://github.com/rzkytmgr/dairi-covid-api",
    "maintainers": "Rizky Aulia Tumangger | rzkytmgr",
    "contact": {
        "email": "rzkytmgr[at]gmail.com",
        "github": "https://github.com/rzkytmgr",
        "instagram": "https://instagram.com/rzkytmgr"
    }
}

Mari kita jelajahi lebih jauh lagi

Seluruh data dengan pengelompokan tanggal/hari

# path
https://covid-dairi.oliak.studio/data

# request
> curl https://covid-dairi.oliak.studio/data

# response
{
    "status": "ok",
    "code": 200,
    "message": "success",
    "data": [
        {
            "id": 1,
            "tanggal": "2020-07-24T00:00:00.000Z",
            "dataUrl": "https://datacovid19.dairikab.go.id/data/1",
            "data": {
                "kontak_erat": 5,
                "suspek": 1,
                "konfirmasi_positif": 3,
                "konfirmasi_sembuh": 3
            }
        },
     	....
     ]
}

Menampilkan data dengan filter identifier, identifier dapat menggunakan tanggal ataupun id data

# path
https://covid-dairi.oliak.studio/data/:id_data
https://covid-dairi.oliak.studio/data/:tanggal_data

# request
> curl https://covid-dairi.oliak.studio/data/1
atau
> curl https://covid-dairi.oliak.studio/data/2020-07-24

# response
{
    "status": "ok",
    "code": 200,
    "message": "success",
    "data": {
        "id": 1,
        "tanggal": "2020-07-24T00:00:00.000Z",
        "dataUrl": "https://datacovid19.dairikab.go.id/data/1",
        "data": {
            "kontak_erat": 5,
            "suspek": 1,
            "konfirmasi_positif": 3,
            "konfirmasi_sembuh": 3
        },
        "kecamatan": [
            {
                "id": 0,
                "nama": "Sidikalang",
                "data": {
                    "kontak_erat": 0,
                    "suspek": 0,
                    "probable": 0,
                    "konfirmasi_positif": 0,
                    "konfirmasi_sembuh": 2,
                    "meninggal": 0
                }
            },
            ....
        ]
    }
}

Data Kecamatan

Menampilkan seluruh kecamatan yang ada

# path
https://covid-dairi.oliak.studio/data/kecamatan/list

# request
> curl https://covid-dairi.oliak.studio/data/kecamatan/list

# response
{
    "status": "ok",
    "code": 200,
    "message": "success",
    "data": [
        {
            "id": 0,
            "nama": "Sidikalang"
        },
        {
            "id": 1,
            "nama": "Sitinjo"
        },
        ...
    ]
}

Akan menampilkan seluruh data yang di kelompokkan sesuai hari/tanggal dan seluruh data pada setiap kecamatan yang ada

# path
https://covid-dairi.oliak.studio/data/kecamatan/

# request
> curl https://covid-dairi.oliak.studio/data/kecamatan/

# response
{
    "status": "ok",
    "code": 200,
    "message": "success",
    "data": [
        {
            "id": 1,
            "tanggal": "2020-07-24T00:00:00.000Z",
            "dataUrl": "https://datacovid19.dairikab.go.id/data/1",
            "data": {
                "kontak_erat": 5,
                "suspek": 1,
                "konfirmasi_positif": 3,
                "konfirmasi_sembuh": 3
            },
            "kecamatan": [
                {
                    "id": 0,
                    "nama": "Sidikalang",
                    "data": {
                        "kontak_erat": 0,
                        "suspek": 0,
                        "probable": 0,
                        "konfirmasi_positif": 0,
                        "konfirmasi_sembuh": 2,
                        "meninggal": 0
                    }
                },
                ...
           ]
        },
        ...
     ]
}

Selanjutnya mengambil data sesuai dengan kecamatan yang diinginkan

# path
https://covid-dairi.oliak.studio/data/kecamatan/:nama_kecamatan

# request
> curl https://covid-dairi.oliak.studio/data/kecamatan/sidikalang

# response
{
    "status": "ok",
    "code": 200,
    "message": "success",
    "data": [
        {
            "id": 1,
            "tanggal": "2020-07-24T00:00:00.000Z",
            "dataUrl": "https://datacovid19.dairikab.go.id/data/1",
            "data": {
                "id": 0,
                "nama": "Sidikalang",
                "data": {
                    "kontak_erat": 0,
                    "suspek": 0,
                    "probable": 0,
                    "konfirmasi_positif": 0,
                    "konfirmasi_sembuh": 2,
                    "meninggal": 0
                }
            }
        },
        ...
    ]
}

Contributors