Tuổi, can chi, mệnh API
Từ ngày sinh: năm âm lịch (tính từ Tết), can chi, con giáp, mệnh nạp âm, cung phi, tuổi mụ, màu hợp và các tuổi tam hợp, tứ hành xung.
API tuổi tính các thông tin truyền thống của năm sinh mà nhiều ứng dụng Việt Nam hiển thị: năm âm lịch (người sinh trước Tết thuộc năm âm trước, tính theo lịch âm), tên can chi (Canh Ngọ, Giáp Tý…), con giáp (12 con giáp Việt Nam có Mèo thay cho Thỏ), mệnh nạp âm (Lộ Bàng Thổ – “đất ven đường”), hành tương sinh, tương khắc cùng các màu hợp và màu nên tránh.
Khi có gender, API thêm cung phi theo Bát trạch (Khảm, Ly, Càn…), ngũ hành, hướng và nhóm Đông / Tây tứ mệnh; không có giới tính thì trả cả hai. Phản hồi còn có tuổi dương, tuổi mụ (tính từ 1 và cộng thêm mỗi khi qua Tết) và các tuổi tam hợp, tứ hành xung.
Đây là tín ngưỡng văn hoá, hữu ích cho tính năng cưới hỏi, phong thuỷ, quà tặng và giải trí; cách tính theo các bảng truyền thống phổ biến.
Tham số
| Tên | Vị trí | Kiểu | Bắt buộc | Mặc định | |
|---|---|---|---|---|---|
birth_date | query|body | string | không | Ngày sinh YYYY-MM-DD (hoặc year=YYYY). | |
year | query|body | number | không | Chỉ năm sinh âm lịch. | |
gender | query|body | string | không | male / female (hoặc nam / nữ) để tính cung phi. |
Ví dụ
curl "https://apibox.io.vn/v1/vn-zodiac?birth_date=1990-05-20&gender=male" \
-H "Authorization: Bearer YOUR_API_KEY"const res = await fetch('https://apibox.io.vn/v1/vn-zodiac?birth_date=1990-05-20&gender=male', {
method: 'GET',
headers: {
Authorization: 'Bearer YOUR_API_KEY',
},
});
const data = await res.json();
console.log(data);import requests
res = requests.get(
"https://apibox.io.vn/v1/vn-zodiac?birth_date=1990-05-20&gender=male",
headers={"Authorization": "Bearer YOUR_API_KEY"},
timeout=30,
)
print(res.json())<?php
$ch = curl_init('https://apibox.io.vn/v1/vn-zodiac?birth_date=1990-05-20&gender=male');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY'],
]);
$response = curl_exec($ch);
print_r(json_decode($response, true));Kết quả trả về
{
"input": "1990-05-20",
"solar_year": 1990,
"lunar_year": 1990,
"can_chi": "Canh Ngọ",
"can": "Canh",
"chi": "Ngọ",
"con_giap": {
"vi": "Ngựa",
"en": "Horse"
},
"age": {
"western": 36,
"lunar": 37
},
"menh": {
"nap_am": "Lộ Bàng Thổ",
"meaning": "Đất ven đường",
"element": "Thổ",
"element_en": "Earth",
"generated_by": "Hỏa",
"generates": "Kim",
"overcomes": "Thủy",
"overcome_by": "Mộc",
"lucky_colors": [
"vàng",
"nâu đất",
"đỏ",
"hồng",
"cam",
"tím"
],
"colors_to_avoid": [
"xanh lá"
]
},
"cung_phi": {
"number": 1,
"cung": "Khảm",
"element": "Thủy",
"direction": "Bắc",
"group": "Đông tứ mệnh"
},
"compatible": {
"tam_hop": [
"Dần",
"Tuất"
],
"tu_hanh_xung": [
"Tý",
"Mão",
"Dậu"
]
},
"disclaimer": "Traditional beliefs, for culture and entertainment."
}
Ứng dụng
- Ứng dụng tử vi, lịch âm
- Tính năng xem ngày cưới, tổ chức sự kiện
- Lời chúc, gợi ý quà tặng cá nhân hoá
- App bất động sản gợi ý hướng nhà theo cung phi
Hỏi đáp
Vì sao năm âm khác năm sinh?
Nếu sinh vào tháng 1, tháng 2 dương lịch trước Tết thì thuộc năm âm lịch trước đó (ví dụ 20/01/2000 → Kỷ Mão 1999).
Tuổi mụ là gì?
Cách tính tuổi truyền thống: 1 tuổi khi sinh ra, cộng thêm một tuổi mỗi dịp Tết, nên thường lớn hơn tuổi dương 1–2 tuổi.
Vì sao cần giới tính?
Cung phi (quẻ Bát trạch) tính khác nhau cho nam và nữ; mệnh nạp âm thì không phụ thuộc giới tính.
API liên quan
Tạo UUID
Sinh tối đa 1.000 UUID v4, UUID v7 theo thời gian, ULID, Nano ID hoặc mã hex ngẫu nhiên mỗi request. Ngẫu nhiên an toàn, hỗ trợ chữ in hoa.
⏱Phân tích biểu thức cron
Kiểm tra biểu thức cron và xem các lần chạy tiếp theo theo múi giờ bất kỳ, kèm mô tả dễ hiểu. Hỗ trợ cú pháp cron 5, 6 và 7 trường.
🕒Giờ & múi giờ
Lấy giờ hiện tại ở mọi múi giờ, đổi giữa các múi giờ và Unix timestamp (giây hoặc mili giây), kèm độ lệch UTC và thứ trong tuần cho tối đa 30 múi giờ.