快速开始
欢迎使用 ApiWorks。本 API 提供多产品线接口能力,帮助开发者快速接入稳定的业务接口。
API 信息
- 版本: 1.1.0
- 基础URL:
https://cloud.apiworks.com/open/astro - 协议: HTTPS
- 数据格式: JSON
Token类型说明
以下为测试 Token与各产品线定价页三档套餐(基础版、专业版、企业定制版)对应的正式 Token 说明:
测试 Token
获取方式:在控制台的 Token 管理 → 测试 Token 页面免费申请
有效期:1 个月
数量限制:每用户最多可申请 3 个
适用场景:开发测试、功能评估
基础版 Token
专业版 Token
企业定制版 Token
身份验证
所有 API 请求都需要在请求头中包含认证信息:
Headers:
X-App-Id: your_app_id
X-App-Key: your_app_key
如何获取 App ID 和 App Key?
创建 Token 后,可在控制台的 Token 管理 页面查看 App ID 与 App Key。 各类型 Token 的获取方式见上方 快速开始 · Token 类型说明。
注意:请妥善保管您的 API 密钥,不要在客户端代码中暴露。
错误代码
| 状态码 | 描述 | 解决方案 |
|---|---|---|
| 200 | 请求成功 | - |
| 400 | 请求参数错误 | 检查请求参数格式和必填项 |
| 401 | 身份验证失败 | 检查API密钥和Token |
| 422 | 参数验证错误 | 检查参数类型和取值范围 |
| 500 | 服务器内部错误 | 联系技术支持 |
支持的星体
星盘相关接口中使用的星体类型、中文名、英文名及代码如下表所示。接口请求时,请在bodies/asteroids/virtual_bodies参数中传入本表「代码」一列的值。
类型与请求参数对应关系
星盘请求接口中,下表「类型」与参数对应如下:
- 行星 → 参数
bodies - 小行星 → 参数
Asteroids - 虚点 → 参数
virtual_bodies - 拜仁点 → 参数
asteroids或virtual_bodies,二者均可
| 类型 | 中文名 | 英文名 | 代码 |
|---|---|---|---|
| 行星 | 太阳 | Sun | 0 |
| 行星 | 月亮 | Moon | 1 |
| 行星 | 金星 | Venus | 3 |
| 行星 | 木星 | Jupiter | 5 |
| 行星 | 水星 | Mercury | 2 |
| 行星 | 火星 | Mars | 4 |
| 行星 | 土星 | Saturn | 6 |
| 行星 | 天王星 | Uranus | 7 |
| 行星 | 海王星 | Neptune | 8 |
| 行星 | 冥王星 | Pluto | 9 |
| 小行星 | 婚神 | Juno | H |
| 小行星 | 爱神 | Eros | xs433 |
| 小行星 | 灶神 | Vesta | I |
| 小行星 | 智神 | Pallas | G |
| 小行星 | 谷神 | Ceres | F |
| 小行星 | 灵神 | Pholus | E |
| 小行星 | 凯龙 | Chiron | D |
| 拜仁点 | 丘比特 | Cupido | J |
| 拜仁点 | 哈迪斯 | Hades | K |
| 拜仁点 | 宙斯 | Zeus | L |
| 拜仁点 | 克洛诺斯 | Kronos | KR |
| 拜仁点 | 阿波罗 | Apollon | N |
| 拜仁点 | 安德门图斯 | Admetos | O |
| 拜仁点 | 弗卡奴斯 | Vulcanus | P |
| 拜仁点 | 波塞冬 | Poseidon | Q |
| 虚点 | 上升 | Ascendant | 10 |
| 虚点 | 下降 | Des | 18 |
| 虚点 | 中天 | MC | 11 |
| 虚点 | 天底 | IC | 19 |
| 虚点 | 南交 | meanSouthNode | 21 |
| 虚点 | 北交 | meanNode | m |
| 虚点 | 福点 | PartOfFortune | pFortune |
| 虚点 | 莉莉丝 | meanApogee | A |
| 虚点 | 宿命 | Vertex | 13 |
| 虚点 | 东升 | equatAsc | 14 |
| 虚点 | 日月中点 | Sun-Moon | 20 |