Hari Libur & Hari Penting Lainnya API

API ini berguna untuk menampilkan Hari Libur & Hari Penting dalam kalender Indonesia.

Respon API

{
  "date": "2022-05-02", // yyyy-mm-dd
  "event": "Hari Raya Idul Fitri 1443 H",
  "is_national_holiday": true
}

Endpoint

Endpoint	Fungsi
/api	Menampilkan keseluruhan hari libur & hari penting ditahun sekarang
/api?year=2022	Menampilkan keseluruhan hari libur & hari penting ditahun 2022
/api?month=5?year=2022	Menampilkan keseluruhan hari libur & hari penting dibulan Mei tahun 2022

Request endpoint selain daftar diatas dan tahun yang tidak ada dalam database akan menghasilkan array kosong / [ ].

Self-Hosting (Express)

Jika Anda ingin menjalankan API ini secara mandiri menggunakan Express:

1. Salin .env.example menjadi .env dan sesuaikan port jika perlu.
2. Instal dependensi: npm install.
3. Jalankan server:
   • Development: npm run dev
   • Production: npm start

Automation (Penjadwalan)

Untuk menjaga data tetap mutakhir secara otomatis, disarankan untuk menjadwalkan skrip scrape (misalnya sebulan sekali).

Di Windows (Task Scheduler)

Gunakan file scrape.bat yang sudah disediakan:

1. Buka Task Scheduler.
2. Buat Basic Task baru (misal: "Scrape Hari Libur").
3. Atur Trigger ke Monthly atau Weekly.
4. Start in: Wajib Isi. Masukkan alamat lengkap folder project (contoh: C:\Users\Admin\Documents\project-scraper).
5. Pada bagian Action, pilih Start a program dan arahkan ke file scrape.bat.

Di Linux (Cron Job)

Tambahkan baris berikut di crontab -e:

0 0 1 * * cd /path/ke/project && npm run scrape >> scrape.log 2>&1

Sumber Data

Terimakasih untuk Tanggalan.com yang sudah menyediakan data hari libur & hari penting lainnya 🙏

Terima Kasih

Terima kasih untuk satyakresna yang telah membuat api-harilibur. API ini terinspirasi berat dari beliau 🙏