Kumpulan API statis dari data publik yang diterbitkan pemerintah Republik Indonesia. Dibuat dengan Next.js.
Oleh : Yogi Saputro
Sumber data : https://github.com/yogski/indonesian_public_data.
Live API :
HTTP Method | Route | Parameter | Deskripsi | Contoh |
---|---|---|---|---|
GET |
/api/heroes |
- | Tampilkan data semua pahlawan nasional | /api/heroes |
GET |
/api/heroes?name= |
name : string |
Cari pahlawan berdasarkan nama | /api/heroes?name=nasution |
GET |
/api/heroes?q= |
q : string |
Cari pahlawan berdasarkan nama atau deskripsi atau kata kunci | /api/heroes?q=angkatan |
GET |
/api/heroes?alive_in_end=&alive_in_start= |
alive_in_start : integer , alive_in_end : integer |
Cari pahlawan yang hidup di periode tertentu | /api/heroes?alive_in_start=1900&alive_in_end=1945 |
GET |
/api/heroes?birth_year_start=&birth_year_end |
birth_year_start : integer , birth_year_end : integer |
Cari pahlawan yang lahir di rentang tahun tertentu | /api/heroes?birth_year_start=1900&birth_year_end=1945 |
GET |
/api/heroes?death_year_start=&death_year_end |
death_year_start : integer , death_year_end : integer |
Cari pahlawan yang meninggal/gugur di rentang tahun tertentu | /api/heroes?death_year_start=1900&death_year_end=1945 |
GET |
/api/heroes?ascend_year_start=&ascend_year_end |
ascend_year_start : integer , ascend_year_end : integer |
Cari pahlawan yang diangkat sebagai pahlawan nasional di rentang tahun tertentu | /api/heroes?ascend_year_start=1900&ascend_year_end=1945 |
HTTP Method | Route | Deskripsi |
---|---|---|
GET |
/api/volcanoes |
Informasi gunung berapi di Indonesia |
Parameter query API
Param | Deskripsi | Tipe Data | Contoh |
---|---|---|---|
name |
Filter berdasarkan nama gunung | string |
/api/volcanoes?name=merapi |
type |
Filter berdasarkan jenis gunung | enum : stratovulkan kaldera supervulkan maar fumarol kubah lava perisai kerucut kerucut bara bawah laut kompleks |
/api/volcanoes?type=kompleks |
min_height |
Filter berdasarkan ketinggian minimum (dalam meter) | integer / number |
/api/volcanoes?min_height=1800 |
max_height |
Filter ketinggian maksimum (dalam meter) | integer / number |
/api/volcanoes?max_height=2800 |
Berbagai parameter query dapat digunakan secara bersamaan. Misal ingin mencari gunung tipe stratovulkan dengan ketinggian di bawah 3000 meter, gunakan query berikut : /api/volcanoes?type=stratovulkan&max_height=3000
.
HTTP Method | Route | Deskripsi |
---|---|---|
GET |
/api/publishers |
Informasi penerbit buku Indonesia yang terdaftar di IKAPI |
Parameter query API
Param | Deskripsi | Tipe Data | Contoh |
---|---|---|---|
name |
Filter berdasarkan nama penerbit | string |
/api/publishers?name=pustaka |
area |
Filter berdasarkan kode wilayah yang dipilih. Lihat tabel list kode wilayah di bawah untuk keterangan lebih lanjut | string[] |
/api/publishers?area=3&area=10&area=16 |
registered_year_start |
Filter berdasarkan tahun masuk IKAPI (batas bawah) | integer / number |
/api/publishers?registered_year_start=2000 |
registered_year_end |
Filter berdasarkan tahun masuk IKAPI (batas atas) | integer / number |
/api/publishers?registered_year_end=2005 |
count_only |
Tampilkan hanya jumlah data | boolean (0 atau 1) |
/api/publishers?count_only=1 |
Semua parameter query dapat dikombinasikan untuk pencarian spesifik. Contoh:
- Penerbit wilayah DI Yogyakarta yang didirikan sebelum 1995 -->
/api/publishers?area=7®istered_year_end=1995
. - Penerbit dengan nama 'Bintang' yang didirikan antara 2010 dan 2020 -->
/api/publishers?name=bintang®istered_year_start=2010®istered_year_end=2020
- Jumlah penerbit di wilayah Jawa Tengah dan Jawa Timur -->
/api/publishers?area=5&area=6&count_only=1
Apakah API ini bisa diakses gratis?
Ya, API ini bisa diakses secara gratis. Minimal untuk saat ini.
Apakah saya harus login untuk akses API ini?
Tidak, anda tak perlu login atau meminta akses API key. Setidaknya untuk saat ini.
Apakah saya boleh request data untuk ditampilkan di API ini?
Ya, anda bisa mengajukan lewat issue.
Apakah saya bisa berkontribusi di repository ini?
Tentu saja! Saya sangat apresiasi dukungan kontribusi. Proyek ini mengikuti semangat open source. Semakin banyak kontribusi, semakin baik. Anda bisa tambahkan data, atau membuat API dari data publik yang tersedia.
Apakah API ini menggunakan database ?
Tidak, sumber data API ini adalah file JSON yang tersedia di folder data_source
.
Apakah saya boleh mengambil data JSON untuk proyek saya ?
Boleh, dengan syarat anda memberikan credit kepada repository ini sebagai sumber data. Ini sejalan dengan syarat lisensi MIT.