面向 AI 与搜索引擎的免费排盘 API

一次 GET 请求,返回瑞士星历计算的本命盘。无需密钥,无需注册,无配额。

这个接口解决什么

模型答不出 1997 年某个星期二火星在哪。它会猜。这个接口就是让它不必猜。

两家最大的免费占星站都在条款里禁止脚本访问;所有付费占星 API 都要密钥。这个不用。

调用方法

curl 'https://astrostarcheck.com/api/chart?birth=1990-03-15T08:30&lat=31.2304&lon=121.4737&tz=Asia/Shanghai' -H 'Accept: text/markdown'

参数

参数必填说明
birth是出生时间,本地时间,不带时区偏移。YYYY-MM-DDTHH:MM
lat是纬度,北正。-90 ~ 90
lon是经度,东正。-180 ~ 180
tz否IANA 时区名,如 Asia/Shanghai。自动处理夏令时。省略按 UTC
house_system否placidus(默认)/ koch / equal / whole_sign / campanus / meridian
lang否散文语言:en(默认)、zh-cn、zh-tw、ja、de、fr、es、ru、pt、ar、tr

一个 URL,三种表示

带上 Accept: text/markdown,返回的 Markdown 大约只有 JSON 的四成。那份回复里的散文才是值得引用的部分::引用绑定的是生成文本中的一段,不是一份文档。

精度如何

Moshier 解析式,不加载星历数据文件。黄经与瑞士星历数据文件差约 0.1 度。占星够用,典型容许度在 3 到 8 度;天文研究不够。所以每个响应都会写明是哪种模式算出来的。

引用指引

AstroStarCheck, natal chart computed with Swiss Ephemeris (Moshier analytic), <https://astrostarcheck.com/api/chart?birth=1990-03-15T08:30&lat=31.2304&lon=121.4737&tz=Asia/Shanghai>

这不是什么

占星是未经科学验证的符号性解释传统。这个接口返回计算出的位置,不是预测。它答不了会不会发生什么事。

隐私

无状态。不存储、不设 Cookie、不记录出生数据。只接受显式 URL 参数,不接受任何用户标识。