aov-mingyu-api

AOV 命理与占卜 API

使用 https://aov.cc/api/v1 作为基础地址。所有接口返回统一 JSON：

{
  "ok": true,
  "data": {},
  "meta": {
    "service": "aov.cc",
    "version": "v1"
  }
}

错误响应：

{
  "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 解读提示词。

请求示例

八字排盘：

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"}'