免费公开 API · 无需密钥
排盘 API
输入出生日期、时辰与城市，排出真实的紫微斗数命盘与八字四柱。已做真太阳时校正，无需密钥，支持 CORS，且请求内容不作任何保存。
快速开始
一个请求，无需注册：
curl "https://www.14mainstars.com/api/public/chart?date=1993-11-04&hour=21&minute=15&gender=male&cityId=kl&lang=en"返回命主星与稀有度、十二宫、四柱、日主，以及五行分布。
接口
- GET/POST /api/public/chart
- 排盘。必填：date（YYYY-MM-DD）、hour（0-23）、gender（male|female）、cityId。可选：minute、calendar（solar|lunar）、lang（zh|en）、name。
- GET /api/public/cities
- 把出生地名称解析为排盘所需的 cityId。之所以必须提供出生地，是因为命盘要按经度做真太阳时校正。
- /api/public/openapi.json
- OpenAPI 3.1 结构，可直接导入 Postman、OpenAPI 客户端或 ChatGPT Action。
限制与说明
- · 鉴权：无。频率限制：每个 IP 每分钟 20 次排盘请求。
- · 只返回计算出的命盘结构，与网站免费层一致。逐章文字解读属于付费内容，本 API 不会返回。
- · 不保存任何内容：不建立账户、不保存命盘、出生资料不写入数据库；仅保留匿名调用计数。
- · 尽力维护，但不提供 SLA。它同时驱动本站与我们的 ChatGPT 助手，因此会持续可用；但请勿用于关键系统。
- · 紫微斗数与八字是传统象征性体系，供反思参考，并非经验证的预测。
署名
免费使用。若用于公开项目，欢迎（但不强制）链接回 14mainstars.com。本站解读依据 15 部古籍，书目见 典籍出处。