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_ →

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

八字相关接口

前端调用示例见开源演示项目 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_ →

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

紫微斗数接口

前端调用示例见开源演示项目 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_ →

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

星宿相关接口

前端调用示例见开源演示项目 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/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_ →

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

三式·大六壬

前端调用示例见开源演示项目 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报告接口

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响应数据"
  }
}