API 接口文档

API 接入

ApiWorks Astro API

开源演示项目 vue-astro 基于 Vue 3，对接本服务 API，涵盖星座、运势、星盘、紫微、星宿、八字、奇门、六壬、七政四余等模块，可作为请求参数与联调参考。

星座相关

前端调用示例见开源演示项目 vue-astro（星座）：

POST/mySign/{uid}星座相关

我的星座

查询我的星座

  • uid 用户ID
  • 请求体可选 lang，默认 zh-Hans，与旧客户端兼容

return

  • ApiResp: 我的星座
测试接口

请求参数

参数名类型位置必填描述
uidstringpath是

用户ID

X-App-Idstringheader是

Token管理页面的

X-App-Keystringheader是

Token管理页面的

请求体

内容类型: application/json

必填: 是

数据结构
SignQry →

点击查看详细的数据结构定义

请求示例

curl -X POST "https://cloud.apiworks.com/open/astro/mySign/{uid}" \
  -H "X-App-Id: your_app_id" \
  -H "X-App-Key: your_app_key" \
  -H "Content-Type: application/json" \
  -d '{
      "birth_dt": "1999-10-17 21:00:00",
      "longitude": 116.4074,
      "latitude": 39.9042
    }'

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "result": "API响应数据"
  }
}
响应数据结构
ApiResp_MySignRespVo_ →

点击查看详细的响应数据结构定义

GET/signs星座相关

星座列表

查询星座列表

  • 可选查询参数 lang，默认 zh-Hans

return

  • ApiResp: 星座列表
测试接口

请求参数

参数名类型位置必填描述
langstringquery否

语言 支持zh-Hant(繁体中文)、zh-Hans(简体中文)、en(English) 默认zh-Hans

X-App-Idstringheader是

Token管理页面的

X-App-Keystringheader是

Token管理页面的

请求示例

curl -X GET "https://cloud.apiworks.com/open/astro/signs" \
  -H "X-App-Id: your_app_id" \
  -H "X-App-Key: your_app_key"

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "result": "API响应数据"
  }
}
响应数据结构
ApiResp_list_SignVo__ →

点击查看详细的响应数据结构定义

GET/signs/{sign_id}星座相关

星座信息

查询指定星座的信息

  • sign_id 星座列表返回的星座id, 1-12
  • 可选查询参数 lang，默认 zh-Hans

return

  • ApiResp: 星座信息
测试接口

请求参数

参数名类型位置必填描述
sign_idintegerpath是

星座列表返回的星座id, 1-12

langstringquery否

语言 支持zh-Hant(繁体中文)、zh-Hans(简体中文)、en(English) 默认zh-Hans

X-App-Idstringheader是

Token管理页面的

X-App-Keystringheader是

Token管理页面的

请求示例

curl -X GET "https://cloud.apiworks.com/open/astro/signs/{sign_id}" \
  -H "X-App-Id: your_app_id" \
  -H "X-App-Key: your_app_key"

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "result": "API响应数据"
  }
}
响应数据结构
ApiResp_SignVo_ →

点击查看详细的响应数据结构定义

GET/signs/{sign_id}/compat星座相关

星座配对

查询指定星座的配对信息

  • sign_id 星座列表返回的星座id, 1-12
  • 可选查询参数 lang，默认 zh-Hans

return

  • ApiResp: 星座配对信息
测试接口

请求参数

参数名类型位置必填描述
sign_idintegerpath是

星座列表返回的星座id, 1-12

langstringquery否

语言 支持zh-Hant(繁体中文)、zh-Hans(简体中文)、en(English) 默认zh-Hans

X-App-Idstringheader是

Token管理页面的

X-App-Keystringheader是

Token管理页面的

请求示例

curl -X GET "https://cloud.apiworks.com/open/astro/signs/{sign_id}/compat" \
  -H "X-App-Id: your_app_id" \
  -H "X-App-Key: your_app_key"

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "result": "API响应数据"
  }
}
响应数据结构
ApiResp_dict_int__list_SignCompatVo___ →

点击查看详细的响应数据结构定义

运势相关

前端调用示例见开源演示项目 vue-astro（运势）：

POST/scope/daily_mood运势相关

每日心情

查询每日心情

  • ScopeQryReq 查询每日心情（提供出生时间地点和推运时间）

return

  • ApiResp: 每日心情信息
测试接口

请求参数

参数名类型位置必填描述
X-App-Idstringheader是

Token管理页面的

X-App-Keystringheader是

Token管理页面的

请求体

内容类型: application/json

必填: 是

数据结构
MoodQryReq →

点击查看详细的数据结构定义

请求示例

curl -X POST "https://cloud.apiworks.com/open/astro/scope/daily_mood" \
  -H "X-App-Id: your_app_id" \
  -H "X-App-Key: your_app_key" \
  -H "Content-Type: application/json" \
  -d '{
      "birth_point": {
        "birth_dt": "1999-10-17 21:00:00",
        "longitude": 116.4074,
        "latitude": 39.9042
      }
    }'

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "result": "API响应数据"
  }
}
响应数据结构
ApiResp_DailyMoodVo_ →

点击查看详细的响应数据结构定义

POST/scope/day/{uid}运势相关

日运势

查询日运势

requestBody

  • ScopeQryReq 运势查询参数（提供出生时空点和推运时空点，transit 会自动转换为日对齐）

return

  • ApiResp: 运势信息
测试接口

请求参数

参数名类型位置必填描述
uidstringpath是

用户ID

X-App-Idstringheader是

Token管理页面的

X-App-Keystringheader是

Token管理页面的

请求体

内容类型: application/json

必填: 是

数据结构
ScopeQryReq →

点击查看详细的数据结构定义

请求示例

curl -X POST "https://cloud.apiworks.com/open/astro/scope/day/{uid}" \
  -H "X-App-Id: your_app_id" \
  -H "X-App-Key: your_app_key" \
  -H "Content-Type: application/json" \
  -d '{
      "birth_point": {
        "birth_dt": "1999-10-17 21:00:00",
        "longitude": 116.4074,
        "latitude": 39.9042
      },
      "transit_point": {
        "birth_dt": "1999-10-17 21:00:00",
        "longitude": 116.4074,
        "latitude": 39.9042
      }
    }'

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "result": "API响应数据"
  }
}
响应数据结构
ApiResp_ScopeRespVo_ →

点击查看详细的响应数据结构定义

POST/scope/week/{uid}运势相关

周运势

查询周运势

requestBody

  • ScopeQryReq 运势查询参数（提供出生时空点和推运时空点，transit 会自动转换为周对齐）

return

  • ApiResp: 运势信息
测试接口

请求参数

参数名类型位置必填描述
uidstringpath是

用户ID

X-App-Idstringheader是

Token管理页面的

X-App-Keystringheader是

Token管理页面的

请求体

内容类型: application/json

必填: 是

数据结构
ScopeQryReq →

点击查看详细的数据结构定义

请求示例

curl -X POST "https://cloud.apiworks.com/open/astro/scope/week/{uid}" \
  -H "X-App-Id: your_app_id" \
  -H "X-App-Key: your_app_key" \
  -H "Content-Type: application/json" \
  -d '{
      "birth_point": {
        "birth_dt": "1999-10-17 21:00:00",
        "longitude": 116.4074,
        "latitude": 39.9042
      },
      "transit_point": {
        "birth_dt": "1999-10-17 21:00:00",
        "longitude": 116.4074,
        "latitude": 39.9042
      }
    }'

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "result": "API响应数据"
  }
}
响应数据结构
ApiResp_ScopeRespVo_ →

点击查看详细的响应数据结构定义

POST/scope/month/{uid}运势相关

月运势

查询月运势

requestBody

  • ScopeQryReq 运势查询参数（提供出生时空点和推运时空点，transit 会自动转换为月初对齐）

return

  • ApiResp: 运势信息
测试接口

请求参数

参数名类型位置必填描述
uidstringpath是

用户ID

X-App-Idstringheader是

Token管理页面的

X-App-Keystringheader是

Token管理页面的

请求体

内容类型: application/json

必填: 是

数据结构
ScopeQryReq →

点击查看详细的数据结构定义

请求示例

curl -X POST "https://cloud.apiworks.com/open/astro/scope/month/{uid}" \
  -H "X-App-Id: your_app_id" \
  -H "X-App-Key: your_app_key" \
  -H "Content-Type: application/json" \
  -d '{
      "birth_point": {
        "birth_dt": "1999-10-17 21:00:00",
        "longitude": 116.4074,
        "latitude": 39.9042
      },
      "transit_point": {
        "birth_dt": "1999-10-17 21:00:00",
        "longitude": 116.4074,
        "latitude": 39.9042
      }
    }'

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "result": "API响应数据"
  }
}
响应数据结构
ApiResp_ScopeRespVo_ →

点击查看详细的响应数据结构定义

POST/scope/year/{uid}运势相关

年运势

查询年运势

requestBody

  • ScopeQryReq 运势查询参数（提供出生时空点和推运时空点，transit 会自动转换为年初对齐）

return

  • ApiResp: 运势信息
测试接口

请求参数

参数名类型位置必填描述
uidstringpath是

用户ID

X-App-Idstringheader是

Token管理页面的

X-App-Keystringheader是

Token管理页面的

请求体

内容类型: application/json

必填: 是

数据结构
ScopeQryReq →

点击查看详细的数据结构定义

请求示例

curl -X POST "https://cloud.apiworks.com/open/astro/scope/year/{uid}" \
  -H "X-App-Id: your_app_id" \
  -H "X-App-Key: your_app_key" \
  -H "Content-Type: application/json" \
  -d '{
      "birth_point": {
        "birth_dt": "1999-10-17 21:00:00",
        "longitude": 116.4074,
        "latitude": 39.9042
      },
      "transit_point": {
        "birth_dt": "1999-10-17 21:00:00",
        "longitude": 116.4074,
        "latitude": 39.9042
      }
    }'

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "result": "API响应数据"
  }
}
响应数据结构
ApiResp_ScopeRespVo_ →

点击查看详细的响应数据结构定义

单点星盘

前端调用示例见开源演示项目 vue-astro（本命盘、天象盘等）：

POST/chart/natal单点星盘

本命盘查询

requestBody

  • SinglePointQry 本命盘查询参数

return

  • ApiResp[AstroDataVo]: 星盘信息
测试接口

请求参数

参数名类型位置必填描述
X-App-Idstringheader是

Token管理页面的

X-App-Keystringheader是

Token管理页面的

请求体

内容类型: application/json

必填: 是

数据结构
SinglePointQry →

点击查看详细的数据结构定义

请求示例

curl -X POST "https://cloud.apiworks.com/open/astro/chart/natal" \
  -H "X-App-Id: your_app_id" \
  -H "X-App-Key: your_app_key" \
  -H "Content-Type: application/json" \
  -d '{
      "birth_dt": "1999-10-17 21:00:00",
      "longitude": 116.4074,
      "latitude": 39.9042
    }'

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "result": "API响应数据"
  }
}
响应数据结构
ApiResp_AstroDataVo_ →

点击查看详细的响应数据结构定义

POST/chart/current单点星盘

天象盘查询

requestBody

  • SinglePointQry 天象盘查询参数（查询给定时间地点的天象）

return

  • ApiResp[AstroDataVo]: 星盘信息
测试接口

请求参数

参数名类型位置必填描述
X-App-Idstringheader是

Token管理页面的

X-App-Keystringheader是

Token管理页面的

请求体

内容类型: application/json

必填: 是

数据结构
SinglePointQry →

点击查看详细的数据结构定义

请求示例

curl -X POST "https://cloud.apiworks.com/open/astro/chart/current" \
  -H "X-App-Id: your_app_id" \
  -H "X-App-Key: your_app_key" \
  -H "Content-Type: application/json" \
  -d '{
      "birth_dt": "1999-10-17 21:00:00",
      "longitude": 116.4074,
      "latitude": 39.9042
    }'

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "result": "API响应数据"
  }
}
响应数据结构
ApiResp_AstroDataVo_ →

点击查看详细的响应数据结构定义

双点星盘

前端调用示例见开源演示项目 vue-astro（行运、比较、组合、返照等）：

POST/chart/transit双点星盘

行运盘查询

requestBody

  • DoublePointQry 行运盘查询参数（需要两个时空点：user_list[0]为出生信息，user_list[1]为推运时空信息）

return

  • ApiResp[AstroDataVo]: 星盘信息
测试接口

请求参数

参数名类型位置必填描述
X-App-Idstringheader是

Token管理页面的

X-App-Keystringheader是

Token管理页面的

请求体

内容类型: application/json

必填: 是

数据结构
DoublePointQry →

点击查看详细的数据结构定义

请求示例

curl -X POST "https://cloud.apiworks.com/open/astro/chart/transit" \
  -H "X-App-Id: your_app_id" \
  -H "X-App-Key: your_app_key" \
  -H "Content-Type: application/json" \
  -d '{
      "user_list": [
        {
          "birth_dt": "1999-10-17 21:00:00",
          "latitude": 39.9042,
          "longitude": 116.4074,
          "tz": 8
        },
        {
          "birth_dt": "2001-10-17 21:00:00",
          "latitude": 39.9042,
          "longitude": 116.4074,
          "tz": 8
        }
      ]
    }'

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "result": "API响应数据"
  }
}
响应数据结构
ApiResp_AstroDataVo_ →

点击查看详细的响应数据结构定义

POST/chart/relocation双点星盘

迁徙盘查询

requestBody

  • DoublePointQry 迁徙盘查询参数（需要两个时空点：user_list[0]为出生信息，user_list[1]为推运时空信息）
测试接口

请求参数

参数名类型位置必填描述
X-App-Idstringheader是

Token管理页面的

X-App-Keystringheader是

Token管理页面的

请求体

内容类型: application/json

必填: 是

数据结构
DoublePointQry →

点击查看详细的数据结构定义

请求示例

curl -X POST "https://cloud.apiworks.com/open/astro/chart/relocation" \
  -H "X-App-Id: your_app_id" \
  -H "X-App-Key: your_app_key" \
  -H "Content-Type: application/json" \
  -d '{
      "user_list": [
        {
          "birth_dt": "1999-10-17 21:00:00",
          "latitude": 39.9042,
          "longitude": 116.4074,
          "tz": 8
        },
        {
          "birth_dt": "2001-10-17 21:00:00",
          "latitude": 39.9042,
          "longitude": 116.4074,
          "tz": 8
        }
      ]
    }'

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "result": "API响应数据"
  }
}
响应数据结构
ApiResp_AstroDataVo_ →

点击查看详细的响应数据结构定义

POST/chart/comparison双点星盘

比较盘查询

requestBody

  • DoublePointQry 比较盘查询参数

return

  • ApiResp[AstroDataVo]: 星盘信息
测试接口

请求参数

参数名类型位置必填描述
X-App-Idstringheader是

Token管理页面的

X-App-Keystringheader是

Token管理页面的

请求体

内容类型: application/json

必填: 是

数据结构
DoublePointQry →

点击查看详细的数据结构定义

请求示例

curl -X POST "https://cloud.apiworks.com/open/astro/chart/comparison" \
  -H "X-App-Id: your_app_id" \
  -H "X-App-Key: your_app_key" \
  -H "Content-Type: application/json" \
  -d '{
      "user_list": [
        {
          "birth_dt": "1999-10-17 21:00:00",
          "latitude": 39.9042,
          "longitude": 116.4074,
          "tz": 8
        },
        {
          "birth_dt": "2001-10-17 21:00:00",
          "latitude": 39.9042,
          "longitude": 116.4074,
          "tz": 8
        }
      ]
    }'

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "result": "API响应数据"
  }
}
响应数据结构
ApiResp_AstroDataVo_ →

点击查看详细的响应数据结构定义

POST/chart/composite双点星盘

组合盘查询

requestBody

  • DoublePointQry 组合盘查询参数

return

  • ApiResp[AstroDataVo]: 星盘信息
测试接口

请求参数

参数名类型位置必填描述
X-App-Idstringheader是

Token管理页面的

X-App-Keystringheader是

Token管理页面的

请求体

内容类型: application/json

必填: 是

数据结构
DoublePointQry →

点击查看详细的数据结构定义

请求示例

curl -X POST "https://cloud.apiworks.com/open/astro/chart/composite" \
  -H "X-App-Id: your_app_id" \
  -H "X-App-Key: your_app_key" \
  -H "Content-Type: application/json" \
  -d '{
      "user_list": [
        {
          "birth_dt": "1999-10-17 21:00:00",
          "latitude": 39.9042,
          "longitude": 116.4074,
          "tz": 8
        },
        {
          "birth_dt": "2001-10-17 21:00:00",
          "latitude": 39.9042,
          "longitude": 116.4074,
          "tz": 8
        }
      ]
    }'

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "result": "API响应数据"
  }
}
响应数据结构
ApiResp_AstroDataVo_ →

点击查看详细的响应数据结构定义

POST/chart/timesMidPoint双点星盘

时空中点盘查询

requestBody

  • DoublePointQry 时空中点盘查询参数

return

  • ApiResp[AstroDataVo]: 星盘信息
测试接口

请求参数

参数名类型位置必填描述
X-App-Idstringheader是

Token管理页面的

X-App-Keystringheader是

Token管理页面的

请求体

内容类型: application/json

必填: 是

数据结构
DoublePointQry →

点击查看详细的数据结构定义

请求示例

curl -X POST "https://cloud.apiworks.com/open/astro/chart/timesMidPoint" \
  -H "X-App-Id: your_app_id" \
  -H "X-App-Key: your_app_key" \
  -H "Content-Type: application/json" \
  -d '{
      "user_list": [
        {
          "birth_dt": "1999-10-17 21:00:00",
          "latitude": 39.9042,
          "longitude": 116.4074,
          "tz": 8
        },
        {
          "birth_dt": "2001-10-17 21:00:00",
          "latitude": 39.9042,
          "longitude": 116.4074,
          "tz": 8
        }
      ]
    }'

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "result": "API响应数据"
  }
}
响应数据结构
ApiResp_AstroDataVo_ →

点击查看详细的响应数据结构定义

POST/chart/marks双点星盘

马克盘查询

requestBody

  • DoublePointQry 马克盘查询参数

return

  • ApiResp[AstroDataVo]: 星盘信息
测试接口

请求参数

参数名类型位置必填描述
X-App-Idstringheader是

Token管理页面的

X-App-Keystringheader是

Token管理页面的

请求体

内容类型: application/json

必填: 是

数据结构
DoublePointQry →

点击查看详细的数据结构定义

请求示例

curl -X POST "https://cloud.apiworks.com/open/astro/chart/marks" \
  -H "X-App-Id: your_app_id" \
  -H "X-App-Key: your_app_key" \
  -H "Content-Type: application/json" \
  -d '{
      "user_list": [
        {
          "birth_dt": "1999-10-17 21:00:00",
          "latitude": 39.9042,
          "longitude": 116.4074,
          "tz": 8
        },
        {
          "birth_dt": "2001-10-17 21:00:00",
          "latitude": 39.9042,
          "longitude": 116.4074,
          "tz": 8
        }
      ]
    }'

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "result": "API响应数据"
  }
}
响应数据结构
ApiResp_AstroDataVo_ →

点击查看详细的响应数据结构定义

POST/chart/lunarReturn双点星盘

月返盘查询

requestBody

  • DoublePointQry 月返盘查询参数（user_list[0]为出生时间地点信息，user_list[1]为目标时间地点信息）

return

  • ApiResp[AstroDataVo]: 星盘信息
测试接口

请求参数

参数名类型位置必填描述
X-App-Idstringheader是

Token管理页面的

X-App-Keystringheader是

Token管理页面的

请求体

内容类型: application/json

必填: 是

数据结构
DoublePointQry →

点击查看详细的数据结构定义

请求示例

curl -X POST "https://cloud.apiworks.com/open/astro/chart/lunarReturn" \
  -H "X-App-Id: your_app_id" \
  -H "X-App-Key: your_app_key" \
  -H "Content-Type: application/json" \
  -d '{
      "user_list": [
        {
          "birth_dt": "1999-10-17 21:00:00",
          "latitude": 39.9042,
          "longitude": 116.4074,
          "tz": 8
        },
        {
          "birth_dt": "2001-10-17 21:00:00",
          "latitude": 39.9042,
          "longitude": 116.4074,
          "tz": 8
        }
      ]
    }'

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "result": "API响应数据"
  }
}
响应数据结构
ApiResp_AstroDataVo_ →

点击查看详细的响应数据结构定义

POST/chart/solarReturn双点星盘

日返盘查询

requestBody

  • DoublePointQry 日返盘查询参数（user_list[0]为出生时间地点信息，user_list[1]为目标时间地点信息）

return

  • ApiResp[AstroDataVo]: 星盘信息
测试接口

请求参数

参数名类型位置必填描述
X-App-Idstringheader是

Token管理页面的

X-App-Keystringheader是

Token管理页面的

请求体

内容类型: application/json

必填: 是

数据结构
DoublePointQry →

点击查看详细的数据结构定义

请求示例

curl -X POST "https://cloud.apiworks.com/open/astro/chart/solarReturn" \
  -H "X-App-Id: your_app_id" \
  -H "X-App-Key: your_app_key" \
  -H "Content-Type: application/json" \
  -d '{
      "user_list": [
        {
          "birth_dt": "1999-10-17 21:00:00",
          "latitude": 39.9042,
          "longitude": 116.4074,
          "tz": 8
        },
        {
          "birth_dt": "2001-10-17 21:00:00",
          "latitude": 39.9042,
          "longitude": 116.4074,
          "tz": 8
        }
      ]
    }'

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "result": "API响应数据"
  }
}
响应数据结构
ApiResp_AstroDataVo_ →

点击查看详细的响应数据结构定义

有推运时间的单点星盘

前端调用示例见开源演示项目 vue-astro（三限、次限、法达等）：

POST/chart/tripleLimit有推运时间的单点星盘

三限盘查询

requestBody

  • SpTransitDateQry 三限盘查询参数（一天对应一个月）

return

  • ApiResp[AstroDataVo]: 星盘信息
测试接口

请求参数

参数名类型位置必填描述
X-App-Idstringheader是

Token管理页面的

X-App-Keystringheader是

Token管理页面的

请求体

内容类型: application/json

必填: 是

数据结构
SpTransitDateQry →

点击查看详细的数据结构定义

请求示例

curl -X POST "https://cloud.apiworks.com/open/astro/chart/tripleLimit" \
  -H "X-App-Id: your_app_id" \
  -H "X-App-Key: your_app_key" \
  -H "Content-Type: application/json" \
  -d '{
      "birth_dt": "1999-10-17 21:00:00",
      "longitude": 116.4074,
      "latitude": 39.9042,
      "transit_dt": "2026-10-17 21:00:00"
    }'

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "result": "API响应数据"
  }
}
响应数据结构
ApiResp_AstroDataVo_ →

点击查看详细的响应数据结构定义

POST/chart/secondaryLimit有推运时间的单点星盘

次限盘查询

requestBody

  • SpTransitDateQry 次限盘查询参数（一天对应一年）

return

  • ApiResp[AstroDataVo]: 星盘信息
测试接口

请求参数

参数名类型位置必填描述
X-App-Idstringheader是

Token管理页面的

X-App-Keystringheader是

Token管理页面的

请求体

内容类型: application/json

必填: 是

数据结构
SpTransitDateQry →

点击查看详细的数据结构定义

请求示例

curl -X POST "https://cloud.apiworks.com/open/astro/chart/secondaryLimit" \
  -H "X-App-Id: your_app_id" \
  -H "X-App-Key: your_app_key" \
  -H "Content-Type: application/json" \
  -d '{
      "birth_dt": "1999-10-17 21:00:00",
      "longitude": 116.4074,
      "latitude": 39.9042,
      "transit_dt": "2026-10-17 21:00:00"
    }'

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "result": "API响应数据"
  }
}
响应数据结构
ApiResp_AstroDataVo_ →

点击查看详细的响应数据结构定义

POST/chart/firdaria有推运时间的单点星盘

法达盘查询

requestBody

  • SpTransitDateQry 法达盘查询参数

return

  • ApiResp[AstroDataVo]: 星盘信息
测试接口

请求参数

参数名类型位置必填描述
X-App-Idstringheader是

Token管理页面的

X-App-Keystringheader是

Token管理页面的

请求体

内容类型: application/json

必填: 是

数据结构
SpTransitDateQry →

点击查看详细的数据结构定义

请求示例

curl -X POST "https://cloud.apiworks.com/open/astro/chart/firdaria" \
  -H "X-App-Id: your_app_id" \
  -H "X-App-Key: your_app_key" \
  -H "Content-Type: application/json" \
  -d '{
      "birth_dt": "1999-10-17 21:00:00",
      "longitude": 116.4074,
      "latitude": 39.9042,
      "transit_dt": "2026-10-17 21:00:00"
    }'

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "result": "API响应数据"
  }
}
响应数据结构
ApiResp_AstroDataVo_ →

点击查看详细的响应数据结构定义

POST/chart/smallLimit有推运时间的单点星盘

小限盘查询

requestBody

  • SpTransitDateQry 小限盘查询参数

return

  • ApiResp[AstroDataVo]: 星盘信息
测试接口

请求参数

参数名类型位置必填描述
X-App-Idstringheader是

Token管理页面的

X-App-Keystringheader是

Token管理页面的

请求体

内容类型: application/json

必填: 是

数据结构
SpTransitDateQry →

点击查看详细的数据结构定义

请求示例

curl -X POST "https://cloud.apiworks.com/open/astro/chart/smallLimit" \
  -H "X-App-Id: your_app_id" \
  -H "X-App-Key: your_app_key" \
  -H "Content-Type: application/json" \
  -d '{
      "birth_dt": "1999-10-17 21:00:00",
      "longitude": 116.4074,
      "latitude": 39.9042,
      "transit_dt": "2026-10-17 21:00:00"
    }'

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "result": "API响应数据"
  }
}
响应数据结构
ApiResp_AstroDataVo_ →

点击查看详细的响应数据结构定义

POST/chart/solarArc有推运时间的单点星盘

日弧盘查询

requestBody

  • SpTransitDateQry 日弧盘查询参数

return

  • ApiResp[AstroDataVo]: 星盘信息
测试接口

请求参数

参数名类型位置必填描述
X-App-Idstringheader是

Token管理页面的

X-App-Keystringheader是

Token管理页面的

请求体

内容类型: application/json

必填: 是

数据结构
SpTransitDateQry →

点击查看详细的数据结构定义

请求示例

curl -X POST "https://cloud.apiworks.com/open/astro/chart/solarArc" \
  -H "X-App-Id: your_app_id" \
  -H "X-App-Key: your_app_key" \
  -H "Content-Type: application/json" \
  -d '{
      "birth_dt": "1999-10-17 21:00:00",
      "longitude": 116.4074,
      "latitude": 39.9042,
      "transit_dt": "2026-10-17 21:00:00"
    }'

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "result": "API响应数据"
  }
}
响应数据结构
ApiResp_AstroDataVo_ →

点击查看详细的响应数据结构定义

有推运时间的双点星盘

前端调用示例见开源演示项目 vue-astro（马盘、时空三限次限等）：

POST/chart/composeTripleLimit有推运时间的双点星盘

组合三限盘查询

requestBody

  • DpTransitDateQry 组合三限盘查询参数

return

  • ApiResp[AstroDataVo]: 星盘信息
测试接口

请求参数

参数名类型位置必填描述
X-App-Idstringheader是

Token管理页面的

X-App-Keystringheader是

Token管理页面的

请求体

内容类型: application/json

必填: 是

数据结构
DpTransitDateQry →

点击查看详细的数据结构定义

请求示例

curl -X POST "https://cloud.apiworks.com/open/astro/chart/composeTripleLimit" \
  -H "X-App-Id: your_app_id" \
  -H "X-App-Key: your_app_key" \
  -H "Content-Type: application/json" \
  -d '{
      "user_list": [
        {
          "birth_dt": "1999-10-17 21:00:00",
          "latitude": 39.9042,
          "longitude": 116.4074,
          "tz": 8
        },
        {
          "birth_dt": "2001-10-17 21:00:00",
          "latitude": 39.9042,
          "longitude": 116.4074,
          "tz": 8
        }
      ],
      "transit_dt": "2025-10-17 21:00:00"
    }'

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "result": "API响应数据"
  }
}
响应数据结构
ApiResp_AstroDataVo_ →

点击查看详细的响应数据结构定义

POST/chart/composeSecLimit有推运时间的双点星盘

组合次限盘查询

requestBody

  • DpTransitDateQry 组合次限盘查询参数

return

  • ApiResp[AstroDataVo]: 星盘信息
测试接口

请求参数

参数名类型位置必填描述
X-App-Idstringheader是

Token管理页面的

X-App-Keystringheader是

Token管理页面的

请求体

内容类型: application/json

必填: 是

数据结构
DpTransitDateQry →

点击查看详细的数据结构定义

请求示例

curl -X POST "https://cloud.apiworks.com/open/astro/chart/composeSecLimit" \
  -H "X-App-Id: your_app_id" \
  -H "X-App-Key: your_app_key" \
  -H "Content-Type: application/json" \
  -d '{
      "user_list": [
        {
          "birth_dt": "1999-10-17 21:00:00",
          "latitude": 39.9042,
          "longitude": 116.4074,
          "tz": 8
        },
        {
          "birth_dt": "2001-10-17 21:00:00",
          "latitude": 39.9042,
          "longitude": 116.4074,
          "tz": 8
        }
      ],
      "transit_dt": "2025-10-17 21:00:00"
    }'

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "result": "API响应数据"
  }
}
响应数据结构
ApiResp_AstroDataVo_ →

点击查看详细的响应数据结构定义

POST/chart/marksTripleLimit有推运时间的双点星盘

马盘三限盘查询

requestBody

  • DpTransitDateQry 马盘三限盘查询参数

return

  • ApiResp[AstroDataVo]: 星盘信息
测试接口

请求参数

参数名类型位置必填描述
X-App-Idstringheader是

Token管理页面的

X-App-Keystringheader是

Token管理页面的

请求体

内容类型: application/json

必填: 是

数据结构
DpTransitDateQry →

点击查看详细的数据结构定义

请求示例

curl -X POST "https://cloud.apiworks.com/open/astro/chart/marksTripleLimit" \
  -H "X-App-Id: your_app_id" \
  -H "X-App-Key: your_app_key" \
  -H "Content-Type: application/json" \
  -d '{
      "user_list": [
        {
          "birth_dt": "1999-10-17 21:00:00",
          "latitude": 39.9042,
          "longitude": 116.4074,
          "tz": 8
        },
        {
          "birth_dt": "2001-10-17 21:00:00",
          "latitude": 39.9042,
          "longitude": 116.4074,
          "tz": 8
        }
      ],
      "transit_dt": "2025-10-17 21:00:00"
    }'

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "result": "API响应数据"
  }
}
响应数据结构
ApiResp_AstroDataVo_ →

点击查看详细的响应数据结构定义

POST/chart/marksSecLimit有推运时间的双点星盘

马盘次限盘查询

requestBody

  • DpTransitDateQry 马盘次限盘查询参数

return

  • ApiResp[AstroDataVo]: 星盘信息
测试接口

请求参数

参数名类型位置必填描述
X-App-Idstringheader是

Token管理页面的

X-App-Keystringheader是

Token管理页面的

请求体

内容类型: application/json

必填: 是

数据结构
DpTransitDateQry →

点击查看详细的数据结构定义

请求示例

curl -X POST "https://cloud.apiworks.com/open/astro/chart/marksSecLimit" \
  -H "X-App-Id: your_app_id" \
  -H "X-App-Key: your_app_key" \
  -H "Content-Type: application/json" \
  -d '{
      "user_list": [
        {
          "birth_dt": "1999-10-17 21:00:00",
          "latitude": 39.9042,
          "longitude": 116.4074,
          "tz": 8
        },
        {
          "birth_dt": "2001-10-17 21:00:00",
          "latitude": 39.9042,
          "longitude": 116.4074,
          "tz": 8
        }
      ],
      "transit_dt": "2025-10-17 21:00:00"
    }'

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "result": "API响应数据"
  }
}
响应数据结构
ApiResp_AstroDataVo_ →

点击查看详细的响应数据结构定义

POST/chart/tmpTripleLimit有推运时间的双点星盘

时空三限盘查询

requestBody

  • DpTransitDateQry 时空中点三限盘查询参数

return

  • ApiResp[AstroDataVo]: 星盘信息
测试接口

请求参数

参数名类型位置必填描述
X-App-Idstringheader是

Token管理页面的

X-App-Keystringheader是

Token管理页面的

请求体

内容类型: application/json

必填: 是

数据结构
DpTransitDateQry →

点击查看详细的数据结构定义

请求示例

curl -X POST "https://cloud.apiworks.com/open/astro/chart/tmpTripleLimit" \
  -H "X-App-Id: your_app_id" \
  -H "X-App-Key: your_app_key" \
  -H "Content-Type: application/json" \
  -d '{
      "user_list": [
        {
          "birth_dt": "1999-10-17 21:00:00",
          "latitude": 39.9042,
          "longitude": 116.4074,
          "tz": 8
        },
        {
          "birth_dt": "2001-10-17 21:00:00",
          "latitude": 39.9042,
          "longitude": 116.4074,
          "tz": 8
        }
      ],
      "transit_dt": "2025-10-17 21:00:00"
    }'

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "result": "API响应数据"
  }
}
响应数据结构
ApiResp_AstroDataVo_ →

点击查看详细的响应数据结构定义

POST/chart/tmpSecLimit有推运时间的双点星盘

时空次限盘查询

requestBody

  • DpTransitDateQry 时空中点次限盘查询参数

return

  • ApiResp[AstroDataVo]: 星盘信息
测试接口

请求参数

参数名类型位置必填描述
X-App-Idstringheader是

Token管理页面的

X-App-Keystringheader是

Token管理页面的

请求体

内容类型: application/json

必填: 是

数据结构
DpTransitDateQry →

点击查看详细的数据结构定义

请求示例

curl -X POST "https://cloud.apiworks.com/open/astro/chart/tmpSecLimit" \
  -H "X-App-Id: your_app_id" \
  -H "X-App-Key: your_app_key" \
  -H "Content-Type: application/json" \
  -d '{
      "user_list": [
        {
          "birth_dt": "1999-10-17 21:00:00",
          "latitude": 39.9042,
          "longitude": 116.4074,
          "tz": 8
        },
        {
          "birth_dt": "2001-10-17 21:00:00",
          "latitude": 39.9042,
          "longitude": 116.4074,
          "tz": 8
        }
      ],
      "transit_dt": "2025-10-17 21:00:00"
    }'

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "result": "API响应数据"
  }
}
响应数据结构
ApiResp_AstroDataVo_ →

点击查看详细的响应数据结构定义

星象事件相关

POST/event/transit星象事件相关

行运盘星象事件

查询行运盘最近一条星象事件

requestBody

  • ScopeQryReq 运势查询参数

return

  • ApiResp: 星象信息
测试接口

请求参数

参数名类型位置必填描述
X-App-Idstringheader是

Token管理页面的

X-App-Keystringheader是

Token管理页面的

请求体

内容类型: application/json

必填: 是

数据结构
ScopeQryReq →

点击查看详细的数据结构定义

请求示例

curl -X POST "https://cloud.apiworks.com/open/astro/event/transit" \
  -H "X-App-Id: your_app_id" \
  -H "X-App-Key: your_app_key" \
  -H "Content-Type: application/json" \
  -d '{
      "birth_point": {
        "birth_dt": "1999-10-17 21:00:00",
        "longitude": 116.4074,
        "latitude": 39.9042
      },
      "transit_point": {
        "birth_dt": "1999-10-17 21:00:00",
        "longitude": 116.4074,
        "latitude": 39.9042
      }
    }'

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "result": "API响应数据"
  }
}
响应数据结构
ApiResp_AstroEventVo_ →

点击查看详细的响应数据结构定义

POST/event/transit/list星象事件相关

行运盘星象事件列表

查询指定日期前后各一天（共三天）内的行运盘星象事件列表

requestBody

  • ScopeQryReq 运势查询参数

return

  • ApiResp: 星象事件列表，按发生时间升序
测试接口

请求参数

参数名类型位置必填描述
X-App-Idstringheader是

Token管理页面的

X-App-Keystringheader是

Token管理页面的

请求体

内容类型: application/json

必填: 是

数据结构
ScopeQryReq →

点击查看详细的数据结构定义

请求示例

curl -X POST "https://cloud.apiworks.com/open/astro/event/transit/list" \
  -H "X-App-Id: your_app_id" \
  -H "X-App-Key: your_app_key" \
  -H "Content-Type: application/json" \
  -d '{
      "birth_point": {
        "birth_dt": "1999-10-17 21:00:00",
        "longitude": 116.4074,
        "latitude": 39.9042
      },
      "transit_point": {
        "birth_dt": "1999-10-17 21:00:00",
        "longitude": 116.4074,
        "latitude": 39.9042
      }
    }'

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "result": "API响应数据"
  }
}
响应数据结构
ApiResp_List_AstroEventVo__ →

点击查看详细的响应数据结构定义

POST/event/current/list星象事件相关

天象盘星象事件列表

查询指定日期前后各一天（共三天）内的天象盘星象事件列表

requestBody

  • CurrentEventQryReq 查询日期（可选，默认当天）

return

  • ApiResp: 星象事件列表，按发生时间升序
测试接口

请求参数

参数名类型位置必填描述
X-App-Idstringheader是

Token管理页面的

X-App-Keystringheader是

Token管理页面的

请求体

内容类型: application/json

必填: 是

数据结构
CurrentEventQryReq →

点击查看详细的数据结构定义

请求示例

curl -X POST "https://cloud.apiworks.com/open/astro/event/current/list" \
  -H "X-App-Id: your_app_id" \
  -H "X-App-Key: your_app_key" \
  -H "Content-Type: application/json" \
  -d '{}'

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "result": "API响应数据"
  }
}
响应数据结构
ApiResp_List_AstroEventVo__ →

点击查看详细的响应数据结构定义

八字相关

前端调用示例见开源演示项目 vue-astro（生辰）：

POST/bazi/natal八字相关

八字命盘

八字命盘接口。lang 支持 zh-Hans（默认）、zh-Hant。

测试接口

请求参数

参数名类型位置必填描述
X-App-Idstringheader是

Token管理页面的

X-App-Keystringheader是

Token管理页面的

请求体

内容类型: application/json

必填: 是

数据结构
BaziNatalQry →

点击查看详细的数据结构定义

请求示例

curl -X POST "https://cloud.apiworks.com/open/astro/bazi/natal" \
  -H "X-App-Id: your_app_id" \
  -H "X-App-Key: your_app_key" \
  -H "Content-Type: application/json" \
  -d '{
      "birth_dt": "1999-10-17 21:00:00",
      "gender": "male"
    }'

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "result": "API响应数据"
  }
}
响应数据结构
ApiResp_BaziNatalVO_ →

点击查看详细的响应数据结构定义

POST/bazi/flow八字相关

八字流盘

八字流盘接口。lang 支持 zh-Hans（默认）、zh-Hant。

测试接口

请求参数

参数名类型位置必填描述
X-App-Idstringheader是

Token管理页面的

X-App-Keystringheader是

Token管理页面的

请求体

内容类型: application/json

必填: 是

数据结构
BaziFlowQry →

点击查看详细的数据结构定义

请求示例

curl -X POST "https://cloud.apiworks.com/open/astro/bazi/flow" \
  -H "X-App-Id: your_app_id" \
  -H "X-App-Key: your_app_key" \
  -H "Content-Type: application/json" \
  -d '{
      "birth_dt": "1999-10-17 21:00:00",
      "gender": "male"
    }'

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "result": "API响应数据"
  }
}
响应数据结构
ApiResp_BaziFlowVO_ →

点击查看详细的响应数据结构定义

POST/bazi/match八字相关

八字合盘

八字合盘接口。合盘解读从 bazi_interpret_corpus 按五因素组合取文案。

测试接口

请求参数

参数名类型位置必填描述
X-App-Idstringheader是

Token管理页面的

X-App-Keystringheader是

Token管理页面的

请求体

内容类型: application/json

必填: 是

数据结构
BaziMatchQry →

点击查看详细的数据结构定义

请求示例

curl -X POST "https://cloud.apiworks.com/open/astro/bazi/match" \
  -H "X-App-Id: your_app_id" \
  -H "X-App-Key: your_app_key" \
  -H "Content-Type: application/json" \
  -d '{
      "birth_dt": "1999-10-17 21:00:00",
      "gender": "male",
      "other_birth_dt": "1998-10-16 21:00:00",
      "other_gender": "male"
    }'

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "result": "API响应数据"
  }
}
响应数据结构
ApiResp_BaziMatchVO_ →

点击查看详细的响应数据结构定义

POST/bazi/summary八字相关

八字总结

八字总结接口。lang 支持 zh-Hans（默认）、zh-Hant。

测试接口

请求参数

参数名类型位置必填描述
X-App-Idstringheader是

Token管理页面的

X-App-Keystringheader是

Token管理页面的

请求体

内容类型: application/json

必填: 是

数据结构
BaziNatalQry →

点击查看详细的数据结构定义

请求示例

curl -X POST "https://cloud.apiworks.com/open/astro/bazi/summary" \
  -H "X-App-Id: your_app_id" \
  -H "X-App-Key: your_app_key" \
  -H "Content-Type: application/json" \
  -d '{
      "birth_dt": "1999-10-17 21:00:00",
      "gender": "male"
    }'

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "result": "API响应数据"
  }
}
响应数据结构
ApiResp_BaziSummaryVO_ →

点击查看详细的响应数据结构定义

POST/bazi/full八字相关

八字综合

一次返回命盘、流盘、总结。请求同流盘（含可选 target_dt）；lang 支持 zh-Hans（默认）、zh-Hant。

测试接口

请求参数

参数名类型位置必填描述
X-App-Idstringheader是

Token管理页面的

X-App-Keystringheader是

Token管理页面的

请求体

内容类型: application/json

必填: 是

数据结构
BaziFlowQry →

点击查看详细的数据结构定义

请求示例

curl -X POST "https://cloud.apiworks.com/open/astro/bazi/full" \
  -H "X-App-Id: your_app_id" \
  -H "X-App-Key: your_app_key" \
  -H "Content-Type: application/json" \
  -d '{
      "birth_dt": "1999-10-17 21:00:00",
      "gender": "male"
    }'

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "result": "API响应数据"
  }
}
响应数据结构
ApiResp_BaziFullVO_ →

点击查看详细的响应数据结构定义

紫微斗数

前端调用示例见开源演示项目 vue-astro（紫微）：

POST/ziwei/natal紫微斗数

紫微斗数本命盘

紫微斗数本命盘接口（不包含运限数据），适用于只需要查看本命盘信息的场景。

测试接口

请求参数

参数名类型位置必填描述
X-App-Idstringheader是

Token管理页面的

X-App-Keystringheader是

Token管理页面的

请求体

内容类型: application/json

必填: 是

数据结构
ZiweiNatalQry →

点击查看详细的数据结构定义

请求示例

curl -X POST "https://cloud.apiworks.com/open/astro/ziwei/natal" \
  -H "X-App-Id: your_app_id" \
  -H "X-App-Key: your_app_key" \
  -H "Content-Type: application/json" \
  -d '{
      "birth_dt": "1999-10-17 21:00:00",
      "gender": "male"
    }'

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "result": "API响应数据"
  }
}
响应数据结构
ApiResp_ZiweiNatalVo_ →

点击查看详细的响应数据结构定义

POST/ziwei/chart紫微斗数

紫微斗数排盘

紫微斗数排盘接口，含本命/大限/流年/流月/流日/流时各个盘的数据

测试接口

请求参数

参数名类型位置必填描述
X-App-Idstringheader是

Token管理页面的

X-App-Keystringheader是

Token管理页面的

请求体

内容类型: application/json

必填: 是

数据结构
ZiweiQry →

点击查看详细的数据结构定义

请求示例

curl -X POST "https://cloud.apiworks.com/open/astro/ziwei/chart" \
  -H "X-App-Id: your_app_id" \
  -H "X-App-Key: your_app_key" \
  -H "Content-Type: application/json" \
  -d '{
      "birth_dt": "1999-10-17 21:00:00",
      "gender": "male"
    }'

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "result": "API响应数据"
  }
}
响应数据结构
ApiResp_ZiweiChartVo_ →

点击查看详细的响应数据结构定义

POST/ziwei/detail紫微斗数

含信息解读的紫微排盘

紫薇斗数详细信息接口，包括各个盘数据，以及星耀落宫的解读信息

测试接口

请求参数

参数名类型位置必填描述
X-App-Idstringheader是

Token管理页面的

X-App-Keystringheader是

Token管理页面的

请求体

内容类型: application/json

必填: 是

数据结构
ZiweiQry →

点击查看详细的数据结构定义

请求示例

curl -X POST "https://cloud.apiworks.com/open/astro/ziwei/detail" \
  -H "X-App-Id: your_app_id" \
  -H "X-App-Key: your_app_key" \
  -H "Content-Type: application/json" \
  -d '{
      "birth_dt": "1999-10-17 21:00:00",
      "gender": "male"
    }'

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "result": "API响应数据"
  }
}
响应数据结构
ApiResp_ZiweiDetailVo_ →

点击查看详细的响应数据结构定义

POST/ziwei/match紫微斗数

紫微斗数合盘（生年干互飞）

紫微合盘：双方各自排本命盘，再按生年干将四化与禄存/擎羊/陀罗飞入对方十二宫。

  • influence_on_self：对方年干飞入本人盘
  • influence_on_other：本人年干飞入对方盘
测试接口

请求参数

参数名类型位置必填描述
X-App-Idstringheader是

Token管理页面的

X-App-Keystringheader是

Token管理页面的

请求体

内容类型: application/json

必填: 是

数据结构
ZiweiMatchQry →

点击查看详细的数据结构定义

请求示例

curl -X POST "https://cloud.apiworks.com/open/astro/ziwei/match" \
  -H "X-App-Id: your_app_id" \
  -H "X-App-Key: your_app_key" \
  -H "Content-Type: application/json" \
  -d '{
      "birth_dt": "1999-10-17 21:00:00",
      "gender": "male",
      "other_birth_dt": "1999-11-02 12:00:00",
      "other_gender": "male"
    }'

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "result": "API响应数据"
  }
}
响应数据结构
ApiResp_ZiweiMatchVo_ →

点击查看详细的响应数据结构定义

星宿相关

前端调用示例见开源演示项目 vue-astro（星宿关系）：

POST/naks/relations星宿相关

星宿关系查询

查询星宿信息，包括个人的本命星宿和值日星宿，以及二者与他人的本命星宿相互间的关系。

六大关系类型（按亲密度排序）：

  1. 友衰（最轻松）：像朋友/玩伴，轻松愉快但深度不足
  2. 荣亲（最舒适）：如家人般温馨，照顾与被照顾的关系
  3. 危成（利益相关）：带有滤镜色彩，涉及现实利益
  4. 命之星（最相似）：如同另一个自己，默契但需自我接纳
  5. 安坏（最不平衡）：主人与宠物，强烈的吸引与业力纠葛
  6. 业胎（最深刻）：双生火焰，心灵感应但易互相消耗
测试接口

请求参数

参数名类型位置必填描述
X-App-Idstringheader是

Token管理页面的

X-App-Keystringheader是

Token管理页面的

请求体

内容类型: application/json

必填: 是

数据结构
NaksQry →

点击查看详细的数据结构定义

请求示例

curl -X POST "https://cloud.apiworks.com/open/astro/naks/relations" \
  -H "X-App-Id: your_app_id" \
  -H "X-App-Key: your_app_key" \
  -H "Content-Type: application/json" \
  -d '{
      "birth_info": {
        "birth_dt": "1990-01-15 00:00:00",
        "latitude": 39.92,
        "longitude": 116.46,
        "tz": 8,
        "user_id": "user_12345"
      },
      "niu_xiu_handle": "nvxiu",
      "others_birth_info": [
        {
          "birth_dt": "1992-03-20 00:00:00",
          "latitude": 39.92,
          "longitude": 116.46,
          "tz": 8,
          "user_id": "user_67890"
        }
      ]
    }'

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "result": "API响应数据"
  }
}
响应数据结构
ApiResp_NaksVo_ →

点击查看详细的响应数据结构定义

七政四余

前端调用示例见开源演示项目 vue-astro（政余）：

POST/zhengyu/natal七政四余

七政四余本命盘

本命盘：十一曜宫度/宿度、命度、十二宫、迟留伏逆、垣殿、会合、恩用仇难、盘面解读。

不含行运。lang 支持 zh-Hans（默认）、zh-Hant（en 回退简体）。
响应含 reading（总纲 + 要点），与基础/化曜/格局平级。

测试接口

请求参数

参数名类型位置必填描述
X-App-Idstringheader是

Token管理页面的

X-App-Keystringheader是

Token管理页面的

请求体

内容类型: application/json

必填: 是

数据结构
QizhengNatalQry →

点击查看详细的数据结构定义

请求示例

curl -X POST "https://cloud.apiworks.com/open/astro/zhengyu/natal" \
  -H "X-App-Id: your_app_id" \
  -H "X-App-Key: your_app_key" \
  -H "Content-Type: application/json" \
  -d '{
      "birth_dt": "1999-10-17 21:00:00",
      "gender": "male"
    }'

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "result": "API响应数据"
  }
}
响应数据结构
ApiResp_QizhengNatalVo_ →

点击查看详细的响应数据结构定义

POST/zhengyu/chart七政四余

七政四余排盘（本命+行运）

在本命盘之上返回流十一曜、当前诸限与按岁限表。

target_dt 不传则用请求时区当天 12:00:00。lang 支持 zh-Hans（默认）、zh-Hant（en 回退简体）。
reading 与本命相同结构，并附 timing（当前大限/小限等）。

测试接口

请求参数

参数名类型位置必填描述
X-App-Idstringheader是

Token管理页面的

X-App-Keystringheader是

Token管理页面的

请求体

内容类型: application/json

必填: 是

数据结构
QizhengQry →

点击查看详细的数据结构定义

请求示例

curl -X POST "https://cloud.apiworks.com/open/astro/zhengyu/chart" \
  -H "X-App-Id: your_app_id" \
  -H "X-App-Key: your_app_key" \
  -H "Content-Type: application/json" \
  -d '{
      "birth_dt": "1999-10-17 21:00:00",
      "gender": "male"
    }'

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "result": "API响应数据"
  }
}
响应数据结构
ApiResp_QizhengChartVo_ →

点击查看详细的响应数据结构定义

POST/zhengyu/comparison七政四余

七政四余比较盘

双人比较盘（合盘）：把两个人的本命星曜叠放在同一张星盘上，用于分析两人关系。

user_list[0] 为第一人（A，主盘），user_list[1] 为第二人（B，对比盘）；
B 的星曜复用行运字段返回：flow_stars / flow_aspects / palaces[].flow_spirit_stars，
合盘解读在 reading.relation 字段；本接口不包含行运及大限/小限信息。

测试接口

请求参数

参数名类型位置必填描述
X-App-Idstringheader是

Token管理页面的

X-App-Keystringheader是

Token管理页面的

请求体

内容类型: application/json

必填: 是

数据结构
QizhengComparisonQry →

点击查看详细的数据结构定义

请求示例

curl -X POST "https://cloud.apiworks.com/open/astro/zhengyu/comparison" \
  -H "X-App-Id: your_app_id" \
  -H "X-App-Key: your_app_key" \
  -H "Content-Type: application/json" \
  -d '{
      "user_list": [
        {
          "birth_dt": "1973-09-05 05:48:31",
          "gender": "male",
          "latitude": 39.91,
          "longitude": 116.39,
          "tz": 8
        },
        {
          "birth_dt": "2000-06-15 12:00:00",
          "gender": "female",
          "latitude": 39.91,
          "longitude": 116.39,
          "tz": 8
        }
      ]
    }'

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "result": "API响应数据"
  }
}
响应数据结构
ApiResp_QizhengComparisonVo_ →

点击查看详细的响应数据结构定义

三式·奇门遁甲

前端调用示例见开源演示项目 vue-astro（奇门）：

POST/qimen三式·奇门遁甲

奇门遁甲排盘

请求体为 QimenQry：起局类型、排盘方式、定局方法、lang（zh-Hans/zh-Hant）、dingju_*（按 ju_method 取用，多余字段忽略）、时柱来源等。
成功时 data 为统一模型 QimenResultVo（pan_variant 区分时家 / 日家金函玉镜 / 日家传统日盘等）。

测试接口

请求参数

参数名类型位置必填描述
X-App-Idstringheader是

Token管理页面的

X-App-Keystringheader是

Token管理页面的

请求体

内容类型: application/json

必填: 是

数据结构
QimenQry →

点击查看详细的数据结构定义

请求示例

curl -X POST "https://cloud.apiworks.com/open/astro/qimen" \
  -H "X-App-Id: your_app_id" \
  -H "X-App-Key: your_app_key" \
  -H "Content-Type: application/json" \
  -d '{
      "ju_method": "chaibu",
      "pai_method": "zhuanpan",
      "qry_dt": "1999-10-17 21:00:00",
      "type": "shijia",
      "tz": 8
    }'

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "result": "API响应数据"
  }
}
响应数据结构
ApiResp_QimenResultVo_ →

点击查看详细的响应数据结构定义

POST/qimen/select三式·奇门遁甲

奇门择吉（逐时辰吉凶 + 九宫方位）

请求体为 QimenSelectQry：起始时刻（qry_dt）、days（1~10，默认 7，每 2 小时一时辰共 days×12 个时辰）、
matter（12 种用事，如 travel/wealth）、include_directions（是否返回每时辰九宫方位全明细）、
时家排盘参数（pai_method/feipan_style/ju_method，默认转盘拆补）。
成功时 data 为 QimenSelectResultVo（best/avoid 快捷 + 按时辰分数降序的 hours）。

测试接口

请求参数

参数名类型位置必填描述
X-App-Idstringheader是

Token管理页面的

X-App-Keystringheader是

Token管理页面的

请求体

内容类型: application/json

必填: 是

数据结构
QimenSelectQry →

点击查看详细的数据结构定义

请求示例

curl -X POST "https://cloud.apiworks.com/open/astro/qimen/select" \
  -H "X-App-Id: your_app_id" \
  -H "X-App-Key: your_app_key" \
  -H "Content-Type: application/json" \
  -d '{
      "days": 3,
      "include_directions": false,
      "ju_method": "chaibu",
      "matter": "travel",
      "pai_method": "zhuanpan",
      "qry_dt": "2026-08-16 14:00:00",
      "tz": 8
    }'

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "result": "API响应数据"
  }
}
响应数据结构
ApiResp_QimenSelectResultVo_ →

点击查看详细的响应数据结构定义

三式·大六壬

前端调用示例见开源演示项目 vue-astro（大六壬）：

POST/liuren三式·大六壬

大六壬排盘

请求体为 LiurenQry：术式类型、贵人起法、查询时间、时区与 lang（zh-Hans/zh-Hant）等。
支持 daliuren（大六壬）与 jinkoujue（金口诀，可选 di_fen 地分）。

测试接口

请求参数

参数名类型位置必填描述
X-App-Idstringheader是

Token管理页面的

X-App-Keystringheader是

Token管理页面的

请求体

内容类型: application/json

必填: 是

数据结构
LiurenQry →

点击查看详细的数据结构定义

请求示例

curl -X POST "https://cloud.apiworks.com/open/astro/liuren" \
  -H "X-App-Id: your_app_id" \
  -H "X-App-Key: your_app_key" \
  -H "Content-Type: application/json" \
  -d '{
      "gui_method": "tian",
      "qry_dt": "1999-10-17 21:00:00",
      "type": "daliuren",
      "tz": 8
    }'

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "result": "API响应数据"
  }
}
响应数据结构
ApiResp_LiurenResultVo_ →

点击查看详细的响应数据结构定义

AI报告

POST/report/romanticAI报告

桃花报告

桃花报告请求参数
提供用户的出生及当前时空点信息

测试接口

请求参数

参数名类型位置必填描述
X-App-Idstringheader是

Token管理页面的

X-App-Keystringheader是

Token管理页面的

请求体

内容类型: application/json

必填: 是

数据结构
RomanticCreateQry →

点击查看详细的数据结构定义

请求示例

curl -X POST "https://cloud.apiworks.com/open/astro/report/romantic" \
  -H "X-App-Id: your_app_id" \
  -H "X-App-Key: your_app_key" \
  -H "Content-Type: application/json" \
  -d '{
      "user_birth_point": {
        "birth_dt": "1999-10-17 21:00:00",
        "longitude": 116.4074,
        "latitude": 39.9042
      },
      "user_current_point": {
        "birth_dt": "1999-10-17 21:00:00",
        "longitude": 116.4074,
        "latitude": 39.9042
      },
      "user_id": "12345"
    }'

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "result": "API响应数据"
  }
}
响应数据结构
ApiResp →

点击查看详细的响应数据结构定义

POST/report/weeklyScopeAI报告

周运报告

周运势报告请求参数
带推运日期的查询参数

测试接口

请求参数

参数名类型位置必填描述
X-App-Idstringheader是

Token管理页面的

X-App-Keystringheader是

Token管理页面的

请求体

内容类型: application/json

必填: 是

数据结构
WeeklyScopeCreateQry →

点击查看详细的数据结构定义

请求示例

curl -X POST "https://cloud.apiworks.com/open/astro/report/weeklyScope" \
  -H "X-App-Id: your_app_id" \
  -H "X-App-Key: your_app_key" \
  -H "Content-Type: application/json" \
  -d '{
      "user_birth_point": {
        "birth_dt": "1999-10-17 21:00:00",
        "longitude": 116.4074,
        "latitude": 39.9042
      },
      "transit_dt": "2026-01-01 01:02:03",
      "user_id": "12345"
    }'

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "result": "API响应数据"
  }
}
响应数据结构
ApiResp →

点击查看详细的响应数据结构定义

POST/report/yearlyScopeAI报告

年运报告

年运势报告请求参数
带推运日期的查询参数

测试接口

请求参数

参数名类型位置必填描述
X-App-Idstringheader是

Token管理页面的

X-App-Keystringheader是

Token管理页面的

请求体

内容类型: application/json

必填: 是

数据结构
YearlyScopeCreateQry →

点击查看详细的数据结构定义

请求示例

curl -X POST "https://cloud.apiworks.com/open/astro/report/yearlyScope" \
  -H "X-App-Id: your_app_id" \
  -H "X-App-Key: your_app_key" \
  -H "Content-Type: application/json" \
  -d '{
      "user_birth_point": {
        "birth_dt": "1999-10-17 21:00:00",
        "longitude": 116.4074,
        "latitude": 39.9042
      },
      "transit_dt": "2026-01-01 01:02:03",
      "user_id": "12345"
    }'

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "result": "API响应数据"
  }
}
响应数据结构
ApiResp →

点击查看详细的响应数据结构定义

POST/report/togetherAI报告

合盘报告

合盘报告请求参数
用户及对方的出生时空点信息

测试接口

请求参数

参数名类型位置必填描述
X-App-Idstringheader是

Token管理页面的

X-App-Keystringheader是

Token管理页面的

请求体

内容类型: application/json

必填: 是

数据结构
TogetherCreateQry →

点击查看详细的数据结构定义

请求示例

curl -X POST "https://cloud.apiworks.com/open/astro/report/together" \
  -H "X-App-Id: your_app_id" \
  -H "X-App-Key: your_app_key" \
  -H "Content-Type: application/json" \
  -d '{
      "user_birth_point": {
        "birth_dt": "1999-10-17 21:00:00",
        "longitude": 116.4074,
        "latitude": 39.9042
      },
      "other_birth_point": {
        "birth_dt": "1999-10-17 21:00:00",
        "longitude": 116.4074,
        "latitude": 39.9042
      },
      "user_id": "12345"
    }'

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "result": "API响应数据"
  }
}
响应数据结构
ApiResp →

点击查看详细的响应数据结构定义

POST/report/wealthAI报告

财运报告

财运报告请求参数
单时空点查询参数

测试接口

请求参数

参数名类型位置必填描述
X-App-Idstringheader是

Token管理页面的

X-App-Keystringheader是

Token管理页面的

请求体

内容类型: application/json

必填: 是

数据结构
WealthCreateQry →

点击查看详细的数据结构定义

请求示例

curl -X POST "https://cloud.apiworks.com/open/astro/report/wealth" \
  -H "X-App-Id: your_app_id" \
  -H "X-App-Key: your_app_key" \
  -H "Content-Type: application/json" \
  -d '{
      "user_birth_point": {
        "birth_dt": "1999-10-17 21:00:00",
        "longitude": 116.4074,
        "latitude": 39.9042
      },
      "user_id": "12345"
    }'

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "result": "API响应数据"
  }
}
响应数据结构
ApiResp →

点击查看详细的响应数据结构定义

GET/report/{uid}/{serial_no}AI报告

查询报告（JSON格式）

查询报告接口，返回JSON格式

这是默认的报告查询接口，向后兼容原有接口

测试接口

请求参数

参数名类型位置必填描述
uidstringpath是

创建报告时提供的用户ID

serial_nostringpath是

创建报告接口返回的序号

X-App-Idstringheader是

Token管理页面的

X-App-Keystringheader是

Token管理页面的

请求示例

curl -X GET "https://cloud.apiworks.com/open/astro/report/{uid}/{serial_no}" \
  -H "X-App-Id: your_app_id" \
  -H "X-App-Key: your_app_key"

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "result": "API响应数据"
  }
}
响应数据结构
ApiResp →

点击查看详细的响应数据结构定义

GET/report/{uid}/{serial_no}/htmlAI报告

查询报告（HTML格式）

查询报告接口，返回HTML格式

返回格式化的HTML页面，适合在浏览器中直接查看

测试接口

请求参数

参数名类型位置必填描述
uidstringpath是

创建报告时提供的用户ID

serial_nostringpath是

创建报告接口返回的序号

X-App-Idstringheader是

Token管理页面的

X-App-Keystringheader是

Token管理页面的

请求示例

curl -X GET "https://cloud.apiworks.com/open/astro/report/{uid}/{serial_no}/html" \
  -H "X-App-Id: your_app_id" \
  -H "X-App-Key: your_app_key"

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "result": "API响应数据"
  }
}