星盘 API 计算服务
本命盘 · 行运盘 · 合盘 · 日/周/月/年运势 —— Swiss Ephemeris 本地计算引擎，API Key 鉴权
⚙ Swiss Ephemeris 精度
🔑 API Key 鉴权
📄 中文化解读语料
🖼 SVG 盘图输出
快速开始
申请 API Key 后，请求头携带
X-Api-Key 即可调用。所有接口返回统一格式：{code, msg, data}，code=0 为成功。# 生成 API Key（服务器端执行） php gen_key.php 我的应用 # 本命盘 curl -X POST https://你的域名/api.php -H "X-Api-Key: xp_xxxx" \ -d "action=chart.natal&birth_dt=1990-06-15 14:30&tz=8&longitude=121.4737&latitude=31.2304"
接口文档
统一入参：出生时间
birth_dt（YYYY-MM-DD HH:MM，本地时间）+ 时区 tz（东八区=8）+ 出生地 longitude / latitude。星盘计算基于 Swiss Ephemeris（Koch 宫位制，与主流平台一致），解读语料为自建中文语料库。1. 本命盘 action=chart.natal
返回：planet（12 星体含相位）/ house（12 宫含宫主星）/ sign / attribute / corpus（解读语料）/ svg（中文化盘图）/ param
| 参数 | 必填 | 说明 |
|---|---|---|
| birth_dt | 是 | 出生时间，如 1990-06-15 14:30 |
| tz | 是 | 出生地时区偏移，东八区 8 |
| longitude / latitude | 是 | 出生地经纬度 |
2. 行运盘 action=chart.transit
本命盘 + 指定时刻行运盘对比：返回 chart1（本命完整盘）/ chart2_planets（行运星体位置）/ house_cusps（宫头）/ aspects（跨盘相位）/ corpus（相位解读）
| 参数 | 必填 | 说明 |
|---|---|---|
| birth_dt / tz / longitude / latitude | 是 | 出生数据（同本命盘） |
| transit_dt | 是 | 行运时刻，如 2026-08-14 12:00（默认同出生地） |
3. 合盘（Synastry） action=chart.synastry
两人星盘对比 + 跨盘相位分析，返回结构同行运盘
| 参数 | 必填 | 说明 |
|---|---|---|
| birth_dt / tz / longitude / latitude | 是 | 第一人生数据 |
| birth2_dt / tz2 / longitude2 / latitude2 | 是 | 第二人生数据 |
4. 更多盘型（21 个接口全本地化）
双点盘、推运盘（单点/双点）、行运星象事件，全部由 Swiss Ephemeris 本地引擎计算，零第三方依赖。传统形态
api.php?action=xxx 与官方形态 POST /open/astro/chart/{name} 均支持。| action | 说明 | 附加参数 |
|---|---|---|
| chart.current | 天象盘 | — |
| chart.relocation | 迁徙盘（换地点） | birth2_* |
| chart.comparison | 比较盘（=synastry） | birth2_* |
| chart.composite | 组合盘 | birth2_* |
| chart.timesMidPoint | 时空中点盘（戴维森） | birth2_* |
| chart.marks | 马克盘 | birth2_* |
| chart.lunarReturn | 月返盘（附 return_time） | transit_dt |
| chart.solarReturn | 日返盘（附 return_time） | transit_dt |
| chart.tripleLimit | 三限盘（附 progressed_date） | transit_dt |
| chart.secondaryLimit | 次限盘（附 progressed_date） | transit_dt |
| chart.firdaria | 法达盘（附 firdaria） | transit_dt |
| chart.smallLimit | 小限盘（附 profection） | transit_dt |
| chart.solarArc | 日弧盘（本命内盘 + 日弧外盘，附 solar_arc） | transit_dt |
| chart.composeTripleLimit / composeSecLimit | 组合三限 / 组合次限 | birth2_* + transit_dt |
| chart.marksTripleLimit / marksSecLimit | 马盘三限 / 马盘次限 | birth2_* + transit_dt |
| chart.tmpTripleLimit / tmpSecLimit | 时空三限 / 时空次限 | birth2_* + transit_dt |
| event.transit | 行运星象事件（最近一条） | ScopeQryReq |
| event.transit.list | 行运盘星象事件列表（指定日 ±1 天） | ScopeQryReq |
| event.current.list | 天象盘星象事件列表（指定日 ±1 天） | CurrentEventQryReq |
5. 运势 POST /open/astro/scope/{day|week|month|year}/{uid} · POST /open/astro/scope/daily_mood
APIWorks 核心协议兼容，本地 Swiss Ephemeris 计算：日/周取 Transit，月取 TripleLimit + LunarReturn，年取 SecondaryLimit + SolarReturn。每日心情使用无 UID 的 MoodQryReq。返回保留官方核心字段，并增加 engine / extensions 本地说明；旧形态 api.php?action=scope.* 仍兼容。
| 参数 | 必填 | 说明 |
|---|---|---|
| birth_point.birth_dt / longitude / latitude | 是 | 出生时空点（tz 可选，默认 8） |
| transit_point | 日/周/月/年：是 | ScopeQryReq 的目标时空点 |
| transit_dt | 每日心情：否 | MoodQryReq 的查询时间，缺省当天 |
| lang | 否 | zh-Hans / zh-Hant / en |
错误码
| code | 含义 |
|---|---|
| 0 | 成功 |
| 400 | 参数缺失或格式错误 |
| 401 | API Key 缺失/无效/已停用 |
| 404 | 未知 action |
| 500 | 本地计算引擎不可用 |
| 502 | 本地运势引擎不可用（swetest 缺失） |
在线调试台
选择接口、填写参数后点击调用（API Key 必填）。
单点星盘
双点星盘
单点推运盘
双点推运盘
星象事件
运势