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.
Thông Tin Kết Nối Cơ Bản (Base URL & Authentication)
https://lichviet.net/wp-json/xla/v1
Bộ Thử Nghiệm API Trực Tiếp (Live API Tester)
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
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ểu | Bắt buộc | Mặc định | Mô tả |
|---|---|---|---|---|
timezone | number | Không | 7.0 | Múi giờ tra cứu (Việt Nam là UTC+7). |
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ểu | Bắt buộc | Mặc định | Mô tả |
|---|---|---|---|---|
day | integer | Có | - | Ngày dương lịch (1 - 31). |
month | integer | Có | - | Tháng dương lịch (1 - 12). |
year | integer | Có | - | Năm dương lịch (1900 - 2100). |
date | string | Không | - | Thay thế cho day/month/year: chuỗi YYYY-MM-DD hoặc DD/MM/YYYY. |
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ểu | Bắt buộc | Mặc định | Mô tả |
|---|---|---|---|---|
month | integer | Không | Tháng hiện tại | Tháng dương lịch cần lấy dữ liệu (1 - 12). |
year | integer | Không | Năm hiện tại | Năm dương lịch (1900 - 2100). |
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ểu | Bắt buộc | Mặc định | Mô tả |
|---|---|---|---|---|
year | integer | Không | Năm hiện tại | Năm dương lịch (1900 - 2100). |
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ểu | Bắt buộc | Mặc định | Mô tả |
|---|---|---|---|---|
type | string | Không | solar_to_lunar | Loại chuyển đổi: `solar_to_lunar` (Dương sang Âm) hoặc `lunar_to_solar` (Âm sang Dương). |
day, month, year | integer | Có | - | Ngày, tháng, năm cần chuyển đổi. |
leap | integer | Không | 0 | Chỉ dùng khi `type=lunar_to_solar`: 1 nếu là tháng nhuận, 0 nếu tháng thường. |
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ệu | Liên kết thử nghiệm |
|---|---|---|
banh_to | Kiêng kỵ theo Thiên Can và Địa Chi của Bành Tổ | /almanac/banh_to |
luc_dieu | Khổng Minh Lục Diệu (Đại An, Tốc Hỷ, Lưu Liên...) | /almanac/luc_dieu |
sao_28 | Nhị 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_12 | Thập Nhị Kiến Trừ (12 Trực: Kiến, Trừ, Mãn, Bình...) | /almanac/truc_12 |
ngay_ky | Ngày kỵ dân gian (Tam Nương, Nguyệt Kỵ, Dương Công, Sát Chủ...) | /almanac/ngay_ky |
ly_thuan_phong | Giờ xuất hành Lý Thuần Phong & dự báo hung kiết | /almanac/ly_thuan_phong |
ngoc_hap | Ngọc Hạp Thông Thư (Chi tiết Cát Tinh và Hung Tinh) | /almanac/ngoc_hap |
nap_am_60 | 60 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";
}
}
?>