Tài Liệu Hướng Dẫn Sử Dụng API Lịch Âm Việt Nam

Hệ thống XemLichAm Open REST API cung cấp dữ liệu âm dương lịch, can chi, hoàng đạo, ngũ hành và cẩm nang phong thủy chính xác 100%, tốc độ phản hồi dưới 1 mili-giây, miễn phí và hỗ trợ CORS cho mọi nền tảng.

201 Năm Dữ Liệu (1900 - 2100)
< 1ms Tốc Độ Xử Lý Tính Toán
100% Miễn Phí & CORS Hoạt Động
10 Danh Mục Cẩm Nang Phong Thủy

Thông Tin Kết Nối Cơ Bản (Base URL & Authentication)

Base URL: https://lichviet.net/wp-json/xla/v1
Định dạng: JSON (Content-Type: application/json; charset=UTF-8)
Xác thực: Không yêu cầu API Key. Công khai 100% cho cộng đồng lập trình viên.
CORS (Cross-Origin): Bật sẵn `Access-Control-Allow-Origin: *`. Gọi trực tiếp mượt mà từ trình duyệt web, frontend React/Vue/Angular, mobile app hay IoT.

Bộ Thử Nghiệm API Trực Tiếp (Live API Tester)

GET https://lichviet.net/wp-json/xla/v1/today
Sẵn sàng 0 ms
Nhấn nút "Gửi Request" ở trên để xem dữ liệu JSON phản hồi trực tiếp...

Danh Sách Chi Tiết Các Endpoint

GET /wp-json/xla/v1/today Hôm nay

Lấy toàn bộ thông tin ngày hiện tại (múi giờ Việt Nam UTC+7): ngày âm, ngày dương, can chi ngày - tháng - năm, ngày Hoàng Đạo/Hắc Đạo, giờ Hoàng Đạo, tiết khí, ngũ hành nạp âm, hướng xuất hành, sao tốt sao xấu Ngọc Hạp Thông Thư.

Tham sốKiểuBắt buộcMặc địnhMô tả
timezonenumberKhông7.0Múi giờ tra cứu (Việt Nam là UTC+7).
GET /wp-json/xla/v1/day Tra cứu ngày

Tra cứu chi tiết một ngày dương lịch bất kỳ trong khoảng 1900 đến 2100. Hỗ trợ cả truyền query param hoặc đường dẫn REST `/day/{year}/{month}/{day}`.

Tham sốKiểuBắt buộcMặc địnhMô tả
dayintegerCó-Ngày dương lịch (1 - 31).
monthintegerCó-Tháng dương lịch (1 - 12).
yearintegerCó-Năm dương lịch (1900 - 2100).
datestringKhông-Thay thế cho day/month/year: chuỗi YYYY-MM-DD hoặc DD/MM/YYYY.
Xem JSON Trực Tiếp
GET /wp-json/xla/v1/month Lịch tháng

Trả về toàn bộ danh sách 28-31 ngày trong tháng: ngày dương tương ứng ngày âm, can chi từng ngày, loại ngày Hoàng Đạo hay Hắc Đạo, danh sách các ngày tốt để xuất hành / khai trương / động thổ trong tháng.

Tham sốKiểuBắt buộcMặc địnhMô tả
monthintegerKhôngTháng hiện tạiTháng dương lịch cần lấy dữ liệu (1 - 12).
yearintegerKhôngNăm hiện tạiNăm dương lịch (1900 - 2100).
Xem JSON Trực Tiếp
GET /wp-json/xla/v1/year Lịch năm & Lễ hội

Tổng quan cả năm: Can Chi năm, con giáp, bản mệnh ngũ hành nạp âm, tháng nhuận (nếu có), tóm tắt 12 tháng và ngày diễn ra toàn bộ các ngày lễ truyền thống lớn tại Việt Nam (Tết Nguyên Đán, Giỗ Tổ Hùng Vương, Tết Đoan Ngọ, Tết Trung Thu, v.v.).

Tham sốKiểuBắt buộcMặc địnhMô tả
yearintegerKhôngNăm hiện tạiNăm dương lịch (1900 - 2100).
Xem JSON Trực Tiếp
GET /wp-json/xla/v1/convert Chuyển đổi ngày

Công cụ chuyển đổi hai chiều chuẩn xác giữa Dương lịch và Âm lịch Việt Nam dựa trên thuật toán thiên văn Hồ Ngọc Đức.

Tham sốKiểuBắt buộcMặc địnhMô tả
typestringKhôngsolar_to_lunarLoại chuyển đổi: `solar_to_lunar` (Dương sang Âm) hoặc `lunar_to_solar` (Âm sang Dương).
day, month, yearintegerCó-Ngày, tháng, năm cần chuyển đổi.
leapintegerKhông0Chỉ dùng khi `type=lunar_to_solar`: 1 nếu là tháng nhuận, 0 nếu tháng thường.
GET /wp-json/xla/v1/almanac/{category} Kho cẩm nang phong thủy

Truy xuất 10 bộ dữ liệu từ điển cổ học: Bành Tổ Bách Kỵ, Lục Diệu, Nhị Thập Bát Tú, Thập Nhị Kiến Trừ, Ngọc Hạp Thông Thư, 60 Hoa Giáp Nạp Âm, Giờ Lý Thuần Phong...

Danh mục (Category)Mô tả dữ liệuLiên kết thử nghiệm
banh_toKiêng kỵ theo Thiên Can và Địa Chi của Bành Tổ/almanac/banh_to
luc_dieuKhổng Minh Lục Diệu (Đại An, Tốc Hỷ, Lưu Liên...)/almanac/luc_dieu
sao_28Nhị Thập Bát Tú (28 chòm sao thiên văn, nên làm và kiêng kỵ)/almanac/sao_28
truc_12Thập Nhị Kiến Trừ (12 Trực: Kiến, Trừ, Mãn, Bình...)/almanac/truc_12
ngay_kyNgày kỵ dân gian (Tam Nương, Nguyệt Kỵ, Dương Công, Sát Chủ...)/almanac/ngay_ky
ly_thuan_phongGiờ xuất hành Lý Thuần Phong & dự báo hung kiết/almanac/ly_thuan_phong
ngoc_hapNgọc Hạp Thông Thư (Chi tiết Cát Tinh và Hung Tinh)/almanac/ngoc_hap
nap_am_6060 Hoa Giáp, Ngũ Hành Nạp Âm & bản mệnh/almanac/nap_am_60

Code Mẫu Tích Hợp Đa Ngôn Ngữ (Code Examples)

# 1. Lấy thông tin âm dương hôm nay
curl -X GET "https://lichviet.net/wp-json/xla/v1/today" -H "Accept: application/json"

# 2. Tra cứu chi tiết một ngày
curl -X GET "https://lichviet.net/wp-json/xla/v1/day/2026/10/29"

# 3. Đổi ngày dương sang âm
curl -X GET "https://lichviet.net/wp-json/xla/v1/convert?type=solar_to_lunar&day=29&month=10&year=2026"
// Gọi API Lịch Âm trực tiếp bằng JavaScript Vanilla (Fetch API)
async function getTodayLunarCalendar() {
    try {
        const response = await fetch('https://lichviet.net/wp-json/xla/v1/today');
        const result = await response.json();
        
        if (result.success) {
            const data = result.data;
            console.log("Ngày Dương:", data.solar.date_str);
            console.log("Ngày Âm:", data.lunar.date_str);
            console.log("Can Chi:", data.can_chi.day);
            console.log("Hoàng Đạo / Hắc Đạo:", data.day_type === 'tot' ? 'Hoàng Đạo' : 'Hắc Đạo');
            console.log("Giờ Hoàng Đạo:", data.gio_hoang_dao);
        }
    } catch (error) {
        console.error("Lỗi khi kết nối API Xem Lịch Âm:", error);
    }
}

getTodayLunarCalendar();
import requests

# Gọi API Lịch Âm bằng Python
url = "https://lichviet.net/wp-json/xla/v1/today"
response = requests.get(url)

if response.status_code == 200:
    res = response.json()
    if res.get("success"):
        data = res["data"]
        print(f"Hôm nay: {data['solar']['day_of_week']}, {data['solar']['date_str']}")
        print(f"Âm lịch: Ngày {data['lunar']['day']} tháng {data['lunar']['month']} năm {data['can_chi']['year']}")
        print(f"Ngày {data['can_chi']['day']} ({'Hoàng Đạo' if data['day_type'] == 'tot' else 'Hắc Đạo'})")
        print(f"Tiết khí: {data['tiet_khi']}")
else:
    print("Không thể kết nối đến máy chủ:", response.status_code)
<?php
// Gọi API Lịch Âm trong PHP
$apiUrl = 'https://lichviet.net/wp-json/xla/v1/today';
$response = file_get_contents($apiUrl);

if ($response !== false) {
    $res = json_decode($response, true);
    if (!empty($res['success'])) {
        $data = $res['data'];
        echo "Ngày Dương: " . $data['solar']['date_str'] . "\n";
        echo "Ngày Âm: " . $data['lunar']['date_str'] . "\n";
        echo "Can Chi Ngày: " . $data['can_chi']['day'] . "\n";
        echo "Tiết Khí: " . $data['tiet_khi'] . "\n";
    }
}
?>