KHGT API Tester

Uji coba interaktif endpoint API Kalender Hijriah Global Tunggal.

Request Configuration

Response JSON

Status: - Time: - ms
Menunggu request...

Panduan Integrasi API

1. Format Standar Respons

Seluruh API menggunakan format balasan baku (RESTful) berbasis JSON:

{
  "success": true, 
  "meta": { "waktu_eksekusi": "..." },
  "data": { ... }
}

Jika terjadi kesalahan (error): {"success": false, "message": "Pesan error"}

2. Endpoint Jadwal Sholat (Rentang Tanggal)

GET /api/schedules

Sangat direkomendasikan untuk aplikasi kalender/jadwal sholat karena dapat menarik data hingga 1 tahun penuh tanpa membebani server (berkat Cloudflare KV Cache).

  • lat & lng: Titik koordinat lokasi (wajib).
  • start_date & end_date: Rentang waktu (YYYY-MM-DD), maksimal 366 hari per request.

3. Endpoint Kalender KHGT Tahunan

GET /api/calendar/:year

Digunakan untuk menarik struktur penanggalan Kalender Hijriah Global Tunggal (KHGT) utuh dalam 1 tahun penuh.

  • :year: Tahun awal yang ingin ditarik.
  • ?type=: Format tahun hijriah atau masehi.
  • ?end_year=: Tahun akhir (opsional, batas tarik hingga 20 tahun sekaligus).