Beranda/Dokumentasi API

API Tanggalan Jawa

Integrasikan Tanggalan Jawa di aplikasi Anda menggunakan API.

Endpoint

Satu endpoint untuk semua data kalender

GET /api/calendar

Menyediakan data kalender Jawa yang mencakup hari (Senin–Minggu) dan pasaran (Legi, Pahing, Pon, Wage, Kliwon) untuk tanggal, bulan, atau tahun tertentu.

Parameter

Setidaknya satu dari year atau month harus disertakan

ParameterTipeWajibDeskripsi
yearnumberYa*Tahun (contoh: 2025)
monthnumberOpsionalBulan (1–12)
daynumberOpsionalTanggal (1–31, memerlukan month)

Contoh Penggunaan

Tiga cara utama memanggil endpoint

1. Semua bulan dalam setahun

GET /api/calendar?year=2025
Lihat contoh response
{
  "january": [
    { "date": "2025-01-01", "day": 1, "weekday": "Rabu", "pasaran": "Kliwon" },
    ...
  ],
  "february": [...],
  ...
}

2. Satu bulan tertentu

GET /api/calendar?year=2025&month=12
Lihat contoh response
{
  "december": [
    { "date": "2025-12-01", "day": 1, "weekday": "Senin", "pasaran": "Pahing" },
    { "date": "2025-12-02", "day": 2, "weekday": "Selasa", "pasaran": "Pon" },
    ...
  ]
}

3. Tanggal spesifik

GET /api/calendar?year=2025&month=12&day=2
Lihat contoh response
{
  "date": "2025-12-02",
  "day": 2,
  "weekday": "Selasa",
  "pasaran": "Pon"
}

4. Bulan ini (year otomatis)

GET /api/calendar?month=12

Akan menggunakan tahun saat ini jika year tidak disertakan.

Format Response

Tahun penuh / bulan

{
  "monthName": [
    {
      "date": "YYYY-MM-DD",
      "day": number,
      "weekday": "Senin|Selasa|Rabu|Kamis|Jumat|Sabtu|Minggu",
      "pasaran": "Legi|Pahing|Pon|Wage|Kliwon"
    }
  ]
}

Tanggal spesifik

{
  "date": "YYYY-MM-DD",
  "day": number,
  "weekday": "Senin|Selasa|Rabu|Kamis|Jumat|Sabtu|Minggu",
  "pasaran": "Legi|Pahing|Pon|Wage|Kliwon"
}

Error

{ "error": "Error message" }

Status Code

200Berhasil
400Parameter tidak valid atau kurang

Contoh Implementasi

Cara memanggil API dari berbagai bahasa

JavaScript / TypeScript

// Mendapatkan data bulan tertentu
const response = await fetch('https://tanggalanjawa.com/api/calendar?year=2025&month=12');
const data = await response.json();

// Mendapatkan tanggal spesifik
const res = await fetch('https://tanggalanjawa.com/api/calendar?year=2025&month=12&day=2');
const day = await res.json();
console.log(day.weekday); // "Selasa"
console.log(day.pasaran); // "Pon"

cURL

curl "https://tanggalanjawa.com/api/calendar?year=2025&month=12"