Logo TanggalanJawa.com

Tanggalan Jawa

API Documentation

Endpoint

GET /api/calendar

Deskripsi

API ini menyediakan data kalender Jawa yang mencakup hari Jawa (Senin-Minggu) dan pasaran (Legi, Pahing, Pon, Wage, Kliwon) untuk tanggal tertentu.

Parameter

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

* year atau month harus ada minimal salah satu

Contoh Penggunaan

1. Mendapatkan semua bulan dalam setahun

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

2. Mendapatkan satu bulan tertentu

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

3. Mendapatkan tanggal spesifik

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

4. Mendapatkan bulan ini (tahun otomatis)

GET /api/calendar?month=12

Akan menggunakan tahun saat ini jika year tidak disebutkan

Response Format

Success Response (Full Year/Month)

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

Success Response (Specific Day)

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

Error Response

{
  "error": "Error message"
}

Status Code

  • 200 - Berhasil
  • 400 - Parameter tidak valid atau kurang

Contoh Implementasi

JavaScript/TypeScript

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

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

cURL

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