aov-mingyu-api

# AOV 命理与占卜 API 使用 `https://aov.cc/api/v1` 作为基础地址。所有接口返回统一 JSON： ```json { "ok": true, "data": {}, "meta": { "service": "aov.cc", "version": "v1" } } ``` 错误响应： ```json { "ok": false, "error": { "code": "BAD_REQUEST", "message": "错误说明" }, "meta": { "service": "aov.cc", "version": "v1" } } ``` ## 工作流 1. 先读取 `GET /manifest` 或 `GET /openapi.json` 确认接口能力。 2. 只需要结构化数据时，调用 `/calculate` 或 `/divination/{method}` 排盘接口。 3. 需要 AI 解读提示词时，优先调用对应 `/prompt` 一站式接口，直接读取 `data.result` 和 `data.prompt`；占卜类接口还会返回 `data.summary`。 4. 向用户展示结果时，说明这是排盘和提示词数据，不替代医疗、法律、投资等专业建议。 ## 常用接口 - `GET /health`：健康检查。 - `GET /manifest`：API 元数据、OpenAPI 地址和 skill 地址。 - `GET /openapi.json`：完整 OpenAPI JSON。 - `POST /bazi/calculate`：八字排盘。 - `POST /bazi/prompt`：八字排盘并生成结构化 AI 解读提示词。 - `POST /ziwei/calculate`：紫微斗数排盘。 - `POST /ziwei/prompt`：紫微斗数排盘并生成结构化 AI 解读提示词。 - `POST /divination/liuyao`：六爻起卦。 - `POST /divination/liuyao/prompt`：六爻起卦并生成结构化 AI 解读提示词。 - `POST /divination/meihua`：梅花易数起卦。 - `POST /divination/meihua/prompt`：梅花易数起卦并生成结构化 AI 解读提示词。 - `POST /divination/xiaoliuren`：小六壬起课。 - `POST /divination/xiaoliuren/prompt`：小六壬起课并生成结构化 AI 解读提示词。 - `POST /divination/qimen`：奇门遁甲排盘。 - `POST /divination/qimen/prompt`：奇门遁甲排盘并生成结构化 AI 解读提示词。 - `POST /divination/liuren`：大六壬排盘。 - `POST /divination/liuren/prompt`：大六壬排盘并生成结构化 AI 解读提示词。 - `POST /divination/tarot`：塔罗抽牌。 - `POST /divination/tarot/prompt`：塔罗抽牌并生成结构化 AI 解读提示词。 - `POST /divination/ssgw`：三山国王灵签求签。模拟传统摇签、掷筊流程，圣杯确认后出签；三连阴杯则拒绝起卦并返回拒绝原因。 - `POST /divination/ssgw/prompt`：三山国王灵签求签并生成结构化 AI 解读提示词。 - `POST /divination/almanac`：黄历择日。 - `POST /divination/almanac/prompt`：黄历择日并生成结构化 AI 解读提示词。 - `POST /divination/lenormand`：雷诺曼抽牌。 - `POST /divination/lenormand/prompt`：雷诺曼抽牌并生成结构化 AI 解读提示词。 - `POST /divination/astrolabe`：星盘生成。 - `POST /divination/astrolabe/prompt`：星盘生成并生成结构化 AI 解读提示词。 ## 请求示例 八字排盘： ```bash curl -X POST https://aov.cc/api/v1/bazi/calculate \ -H "Content-Type: application/json" \ -d '{"gender":"male","year":1990,"month":5,"day":15,"timeIndex":1,"dateType":"solar"}' ``` 紫微斗数排盘： ```bash curl -X POST https://aov.cc/api/v1/ziwei/calculate \ -H "Content-Type: application/json" \ -d '{"name":"测试","gender":"female","dateType":"solar","year":"1992","month":"8","day":"21","timeIndex":4}' ``` 八字排盘并生成提示词： ```bash curl -X POST https://aov.cc/api/v1/bazi/prompt \ -H "Content-Type: application/json" \ -d '{"gender":"male","year":1990,"month":5,"day":15,"timeIndex":1,"dateType":"solar","question":"我适合创业还是上班？","promptTopic":"career"}' ``` 紫微斗数排盘并生成提示词： ```bash curl -X POST https://aov.cc/api/v1/ziwei/prompt \ -H "Content-Type: application/json" \ -d '{"name":"测试","gender":"female","dateType":"solar","year":"1992","month":"8","day":"21","timeIndex":4,"question":"我的感情关系要注意什么？","promptTopic":"relationship","promptScope":"origin"}' ``` 塔罗抽牌： ```bash curl -X POST https://aov.cc/api/v1/divination/tarot \ -H "Content-Type: application/json" \ -d '{"spreadType":"single"}' ``` 塔罗抽牌并生成提示词： ```bash curl -X POST https://aov.cc/api/v1/divination/tarot/prompt \ -H "Content-Type: application/json" \ -d '{"spreadType":"single","question":"我近期事业应该注意什么？"}' ``` 按自定时间起卦并生成提示词： ```bash curl -X POST https://aov.cc/api/v1/divination/liuyao/prompt \ -H "Content-Type: application/json" \ -d '{"customDate":"2025-01-01T08:30:00+08:00","question":"这个项目现在适合推进吗？"}' ``` 八字盲派流派解读： ```bash curl -X POST https://aov.cc/api/v1/bazi/prompt \ -H "Content-Type: application/json" \ -d '{"gender":"male","year":1990,"month":5,"day":15,"timeIndex":1,"dateType":"solar","question":"近期工作发展如何？","promptTopic":"career","school":"mangpai"}' ``` 紫微飞星派流派解读： ```bash curl -X POST https://aov.cc/api/v1/ziwei/prompt \ -H "Content-Type: application/json" \ -d '{"gender":"female","dateType":"solar","year":"1992","month":"8","day":"21","timeIndex":4,"question":"2025年事业财运如何？","promptTopic":"career-wealth","promptScope":"yearly","school":"feixing"}' ``` 奇门飞盘法排盘： ```bash curl -X POST https://aov.cc/api/v1/divination/qimen/prompt \ -H "Content-Type: application/json" \ -d '{"qimenMethod":"feipan","question":"项目现在能推进吗？"}' ``` 黄历安葬择日： ```bash curl -X POST https://aov.cc/api/v1/divination/almanac \ -H "Content-Type: application/json" \ -d '{"topic":"burial","startDate":"2026-07-01","endDate":"2026-07-15"}' ``` 黄历择日： ```bash curl -X POST https://aov.cc/api/v1/divination/almanac \ -H "Content-Type: application/json" \ -d '{"topic":"move","startDate":"2026-06-01","endDate":"2026-06-05","participants":[{"id":"self","name":"本人","gender":"男","year":1990,"month":1,"day":1,"timeIndex":12,"dateType":"solar"}]}' ``` 星盘生成： ```bash curl -X POST https://aov.cc/api/v1/divination/astrolabe \ -H "Content-Type: application/json" \ -d '{"name":"本人","gender":"女","year":1995,"month":5,"day":20,"hour":12,"minute":30,"latitude":39.9042,"longitude":116.4074,"timezone":8,"locationName":"北京"}' ``` ## 参数约定 通用参数： - `gender`：八字和紫微使用 `male` 或 `female`；黄历择日和星盘使用 `男`、`女` 或空字符串。 - `dateType`：使用 `solar`（阳历）或 `lunar`（农历）。 - `timeIndex`：范围为 `0` 到 `12`，其中 `0` 为早子时，`1` 为丑时，...，`11` 为亥时，`12` 为晚子时。 - `isLeapMonth`：布尔值，仅农历有效。 - `useTrueSolarTime`：布尔值，启用真太阳时校正。八字和紫微开启后需提供 `birthHour`、`birthMinute`、`birthLongitude`，此时 `timeIndex` 由程序自动换算；星盘开启后使用 `hour`、`minute` 和 `longitude` 校正。 八字 `promptTopic` 支持以下主题： `general`（综合）、`recent`（近期）、`career`（事业）、`job-change`（跳槽）、`startup-partnership`（创业合作）、`investment-partnership`（投资合作）、`wealth`（财运）、`marriage`（婚恋）、`relationship-push`（感情推进）、`relationship-decision`（关系去留）、`reconciliation-decision`（复合判断）、`children`（子女）、`family`（家庭）、`home-move`（搬家置业）、`settle-relocate`（定居换城）、`social`（人际合作）、`emotion`（情绪心理）、`health`（健康）、`parents`（父母）、`study`（学业）、`study-advance`（考证进修）、`exam-landing`（考试上岸）、`growth`（成长方向）、`talent`（天赋特质）。 紫微 `promptTopic` 支持以下主题： `destiny`（命局）、`relationship`（感情）、`relationship-push`（感情推进）、`relationship-decision`（关系去留）、`career-wealth`（事业财运）、`job-change`（工作变动）、`startup-partnership`（创业合作）、`investment-partnership`（投资合作）、`recent`（近期趋势）、`family`（六亲家庭）、`home-move`（搬家置业）、`settle-relocate`（定居换城）、`social`（人际合作）、`emotion`（情绪心理）、`health`（健康养护）、`study`（学业成长）、`study-advance`（考证进修）、`exam-landing`（考试上岸）、`growth`（成长方向）、`talent`（天赋特质）、`reconciliation-decision`（复合判断）、`life`（人生解析）、`chat`（自由聊天）。 紫微 `promptScope` 支持：`origin`（本命）、`decadal`（大限）、`yearly`（流年）、`monthly`（流月）、`daily`（流日）、`hourly`（流时）、`age`（年龄）。公开 API 返回轻量排盘资料，默认只返回 `origin`；请求传入 `promptScope` 时，会返回 `origin` 加指定范围，包含分析对象、落宫与四化信息。 紫微排盘结果以 `payloadByScope.origin.palaces` 为主结构；接口同时提供 `四化`、`fourMutagens`、`birthMutagens` 和 `gongList`，方便 agent 直接读取生年四化和十二宫星曜。 `promptMode` 支持：`framework`（内置完整框架，默认）、`custom`（只围绕用户问题自由作答，不塞框架）。 八字 `school` 支持：`traditional`（传统派子平正法）、`mangpai`（盲派十神象法）、`xinpai`（新派调候流通）。不传则不附加流派指引。 紫微 `school` 支持：`sanhe`（三合派三方四正）、`feixing`（飞星派四化飞星链路）、`sihua`（四化派生年四化主线）。不传则不附加流派指引。 Python `urllib` 默认 `User-Agent` 可能被 Cloudflare 拦截；Python 调用时请显式设置正常 `User-Agent`，例如 `curl/8.0.0` 或业务自己的客户端名称。 占卜时间参数： - `customDate`：六爻、梅花易数、小六壬、奇门遁甲、大六壬可用该字段指定起卦或排盘时间；不提供则使用当前时间。必须传带时区的 ISO 8601 时间字符串，例如 `2025-01-01T08:00:00+08:00`。 占卜通用参数： - `question`：所有 `/prompt` 接口的必填字段，黄历择日 `/prompt` 中可不填。 - `supplementaryInfo`：对象类型，占卜补充信息。 各占卜方法特有参数： - 梅花易数 `method`：`time`（时间起卦）、`number`（数字起卦）、`random`（随机起卦）、`external`（外应起卦）、`timeTrigram`（时辰纳卦法，依时辰方位配先天八卦取象）。`method` 为 `number` 时需提供 `number`（正整数）；`method` 为 `external` 时需提供 `externalOmens`，至少两项可映射外应，并提供 `count` 作为动爻数量，例如 `{"direction":"南","object":"火电文书","count":3}`；`method` 为 `timeTrigram` 时按时辰地支方位自动取卦，无需额外参数。 - 小六壬 `xiaoliurenMethod`：`time`、`number`、`random`。`number` 时需提供 `xiaoliurenNumber`（正整数）。 - 塔罗 `spreadType`：`single`（单牌指引）、`three`（时间流）、`love`（爱情）、`career`（事业）、`decision`（选择）。 - 六爻 `liuyaoTemplate`：`general`（通用）、`ganqing`（感情）、`shiye`（事业）、`caifu`（财运）、`guaishen`（鬼神怪异）。 - 大六壬 `liurenTemplate`：`general`（通用）、`ganqing`（感情）、`shiye`（事业）、`caifu`（财富）。 - 奇门遁甲 `qimenMethod`：`zhuanpan`（转盘法，默认）、`feipan`（飞盘法）。 - 黄历择日 `topic`：`marriage`（嫁娶）、`move`（搬家）、`opening`（开业）、`contract`（签约）、`travel`（出行）、`medical`（求医）、`study`（求学）、`burial`（安葬修坟）、`renovation`（修造动土）、`custom`（自定义）。 - 黄历择日 `startDate`、`endDate`：日期范围字符串。`participants`：参与者数组，每人包含 `id`、`name`、`gender`、`year`、`month`、`day`、`timeIndex`、`dateType`、`isLeapMonth`。 - 雷诺曼 `spreadType`：`single`（单牌）、`three`（三牌）、`five`（五牌十字阵）、`relationship`（关系）、`decision`（选择）、`nine`（九宫）、`element`（元素牌阵）、`grandTableau`（大桌牌阵）。 - 星盘 `year`、`month`、`day`、`hour`、`minute`：出生时间。`latitude`、`longitude`：经纬度。`timezone`：时区偏移。`locationName`：地点名称。可传 `useTrueSolarTime` 启用真太阳时校正；提示词接口可传 `astrolabeTopic` 和 `astrolabeScopeText`，用于写入本命、流年、流月或流日分析对象。