快速开始

欢迎使用 ApiWorks。本 API 提供多产品线接口能力,帮助开发者快速接入稳定的业务接口。

API 信息

  • 版本: 1.1.0
  • 基础URL: https://cloud.apiworks.com/open/astro
  • 协议: HTTPS
  • 数据格式: JSON

Token类型说明

以下为测试 Token与各产品线定价页三档套餐(基础版、专业版、企业定制版)对应的正式 Token 说明:

测试 Token

获取方式:在控制台的 Token 管理 → 测试 Token 页面免费申请

有效期:1 个月

数量限制:每用户最多可申请 3 个

适用场景:开发测试、功能评估

基础版 Token

获取方式:定价页面选择 基础版,点击 「免费体验」 后系统自动生成

有效期:3 个月

续费:不支持续费延期,可多次重新申请基础版套餐

适用场景:个人开发者、小型项目体验

专业版 Token

获取方式:定价页面购买 专业版 套餐后,系统自动生成

有效期:根据所购套餐时长确定

续费:支持续费,已过期的 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
  • 拜仁点 → 参数 asteroidsvirtual_bodies,二者均可
类型中文名英文名代码
行星太阳Sun0
行星月亮Moon1
行星金星Venus3
行星木星Jupiter5
行星水星Mercury2
行星火星Mars4
行星土星Saturn6
行星天王星Uranus7
行星海王星Neptune8
行星冥王星Pluto9
小行星婚神JunoH
小行星爱神Erosxs433
小行星灶神VestaI
小行星智神PallasG
小行星谷神CeresF
小行星灵神PholusE
小行星凯龙ChironD
拜仁点丘比特CupidoJ
拜仁点哈迪斯HadesK
拜仁点宙斯ZeusL
拜仁点克洛诺斯KronosKR
拜仁点阿波罗ApollonN
拜仁点安德门图斯AdmetosO
拜仁点弗卡奴斯VulcanusP
拜仁点波塞冬PoseidonQ
虚点上升Ascendant10
虚点下降Des18
虚点中天MC11
虚点天底IC19
虚点南交meanSouthNode21
虚点北交meanNodem
虚点福点PartOfFortunepFortune
虚点莉莉丝meanApogeeA
虚点宿命Vertex13
虚点东升equatAsc14
虚点日月中点Sun-Moon20