二十八星宿，是中国古代天文学家为观测日、月、五星运行而划分的二十八个星区，由东方青龙、南方朱雀、西方白虎、北方玄武各七宿组成。
自动推算指定日期（公历或农历）的值日星宿，支持“二十八宿轮流值日”的传统算法。
明确标识星宿所属的四象（东方青龙、西方白虎、南方朱雀、北方玄武）及具体方位。
提供每个星宿的五行属性（金木水火土）、对应的动物形象（如角木蛟、心月狐）及象征意义。
解读当日星宿的吉凶含义，提供嫁娶、开市、动土等日常活动的宜忌建议，辅助择吉。
不仅包含古代天文学的观测数据，更融合了深厚的民俗文化内涵。
算法经过严格校对，确保与《钦定协纪辨方书》等权威古籍的记载一致。
将复杂的星宿信息整理为标准的 JSON 格式，便于开发者快速集成和展示。
构建游戏中的星宿系统、阵法系统或角色属性，增加游戏的文化底蕴。
为用户提供更进阶的择日依据，满足专业用户对“黄道吉日”的精细化需求。
用于各类文化科普网站或小程序，向公众普及中国古代天文学知识。
接口地址：/open/xiu
请求方式：GET
返回类型：JSON
接口描述：二十八星宿，是中国古代天文学家为观测日、月、五星运行而划分的二十八个星区，由东方青龙、南方朱雀、西方白虎、北方玄武各七宿组成。
接口调试：API测试工具
| 名称 | 值 |
|---|
| 名称 | 必填 | 类型 | 说明 |
|---|---|---|---|
| date | 是 | string | Date (yyyy-MM-dd) |
| name | 是 | string | Xiu Name (e.g., 角) |
| 名称 | 类型 | 说明 | 示例值 |
|---|---|---|---|
| animal | string | 神兽 | |
| date | string | 公历日期 | |
| desc | string | 描述 | |
| four_beast | string | 四象 | |
| full_name | string | 全名 | |
| lunar | string | 农历日期 | |
| seven_star | string | 七政(七曜) | |
| xiu | string | 星宿名 | |
| xiu_luck | string | 吉凶 | |
| xiu_song | string | 歌诀 |
{
"code": 200,
"data": {
"animal": "豹",
"date": "2025-05-07",
"desc": "龙尾摆动，象征风口与是非，多主口舌。",
"four_beast": "东方青龙",
"full_name": "箕水豹",
"lunar": "二〇二五年四月初十",
"seven_star": "水",
"xiu": "箕",
"xiu_luck": "吉",
"xiu_song": "箕星造作主高强，岁岁年年大吉昌，埋葬修坟大吉利，田蚕牛马遍山岗，开门放水招田宅，箧满金银谷满仓，福荫高官加禄位，六亲丰禄乐安康。"
},
"msg": "success"
}