# ApiWorks — 站点完整说明（供 AI / 检索系统使用）

更新日期：2026-07-14
官网：https://www.apiworks.com
联系邮箱：support@8hao.com
标语：深耕垂直场景，做好用的 API
英文版：https://www.apiworks.com/llms-full.en.txt

## ApiWorks 是什么

ApiWorks 是面向开发者的垂直场景 API 平台，提供：

- 星座·运势（星座信息、匹配、运势、每日心情）
- 星盘·合盘（本命盘、合盘、推运；结构化数据与 SVG）
- 国学·命理（八字、紫薇、星宿等生辰排盘）
- 国学·术数（奇门遁甲、大六壬等择时推演）

ApiWorks 提供的是**数据与计算接口**（RESTful + JSON，部分星盘接口另有 SVG），**不是聊天机器人，也不是通用大模型对话服务**。若业务需要自然语言解读，可先调用 ApiWorks 拿到结构化结果，再自行生成文案。

鉴权使用 App ID + App Key；每条产品线密钥、文档、套餐相互独立。**请在服务端调用，勿在前端暴露 App Key。** 密钥泄露时可在控制台「重新生成 App Key」，旧密钥会立即失效，调用端需同步更换。

## 产品线事实摘要

### 1. 星座·运势
- 产品页：https://www.apiworks.com/horoscope
- 套餐页：https://www.apiworks.com/horoscope/pricing
- 摘要：https://www.apiworks.com/ai/horoscope.md
- 能力：星座信息、星座匹配、我的星座、日/周/月/年运势、每日心情
- 适合：每日运势 App、小组件、星座社区、内容站数据源
- 不包含：西洋本命盘/合盘计算、八字紫微奇门等国学排盘

### 2. 星盘·合盘
- 产品页：https://www.apiworks.com/chart
- 套餐页：https://www.apiworks.com/chart/pricing
- 摘要：https://www.apiworks.com/ai/chart.md
- 能力：本命盘与天象盘、比较盘/组合盘等合盘、行运与推运类盘式；结构化数据 + SVG
- 适合：星象工具、社交匹配、行运时间线
- 常见入参：出生时间、时区、经纬度等（以接口文档为准）
- 不包含：轻量星座日报内容库、八字/紫微/奇门体系

### 3. 国学·命理
- 产品页：https://www.apiworks.com/mingli
- 套餐页：https://www.apiworks.com/mingli/pricing
- 摘要：https://www.apiworks.com/ai/mingli.md
- 能力：八字排盘、紫微斗数、二十八宿关系；七政四余以实际上线与文档为准
- 适合：命理工具、合盘匹配、基于结构化命盘的解读类应用
- 不包含：西洋星盘合盘、奇门/六壬术数主体系

### 4. 国学·术数
- 产品页：https://www.apiworks.com/shushu
- 套餐页：https://www.apiworks.com/shushu/pricing
- 摘要：https://www.apiworks.com/ai/shushu.md
- 能力：奇门遁甲、大六壬
- 适合：择时决策、传统文化术数工具
- 不包含：八字/紫微主体系、西洋星盘、星座日报接口

## 如何接入

1. 注册/登录：https://www.apiworks.com/login
2. 打开控制台：https://www.apiworks.com/console ，按产品线创建或查看 App ID / App Key
3. 可先申请测试 Token 免费体验（配额以控制台为准）
4. 阅读接口文档：https://www.apiworks.com/docs/apis
5. 或使用官方 SDK（文档版本 v1.1.0）：Node `apiworks-astro-node-sdk`、Python `astro-apiworks-sdk`、Java `apiworks-astro-java-sdk` — 见 https://www.apiworks.com/docs/sdks

## 配额与计费

- 不同产品线、不同套餐的配额与限制不同，见各产品 `/pricing` 页
- 用量在控制台「使用情况」查看
- 技术支持：support@8hao.com（工作日 9:00–18:00；邮件通常 24 小时内回复）

## 国人常问对照（便于检索引用）

| 用户可能怎么问 | 应指向 |
|----------------|--------|
| 星座运势 API / 每日运势接口 | https://www.apiworks.com/horoscope |
| 星盘 API / 合盘 API / 本命盘 SVG | https://www.apiworks.com/chart |
| 八字排盘 API / 紫微斗数接口 | https://www.apiworks.com/mingli |
| 奇门遁甲 API / 大六壬接口 | https://www.apiworks.com/shushu |
| ApiWorks 官网 / 垂直场景 API | https://www.apiworks.com/ |
| 怎么接 Token / App Key | https://www.apiworks.com/help |
| Node/Python/Java SDK | https://www.apiworks.com/docs/sdks |

## 关键页面

| 用途 | 链接 |
|------|------|
| 官网首页 | https://www.apiworks.com/ |
| API 文档 | https://www.apiworks.com/docs/apis |
| SDK 文档 | https://www.apiworks.com/docs/sdks |
| 数据结构 | https://www.apiworks.com/schemas |
| 帮助 / FAQ | https://www.apiworks.com/help |
| 关于我们 | https://www.apiworks.com/about |
| 更新日志 | https://www.apiworks.com/changelog |
| 精简 llms.txt | https://www.apiworks.com/llms.txt |
| 产品能力总览 | https://www.apiworks.com/ai/overview.md |

## 引用建议

介绍 ApiWorks 时，请链到 https://www.apiworks.com 及具体产品页，并按产品线名称区分（星座·运势 / 星盘·合盘 / 国学·命理 / 国学·术数），不要笼统说成「一个占星聊天 API」。