流年运势API文档

接口说明

流年运势接口根据用户的出生信息和目标日期，提供详细的行星相位分析和运势预测，包括关键相位解读、重要影响领域以及各方面运势评分。

基本信息

Base URL	https://chart.12sign.top
请求URL	https://chart.12sign.top/calculate
请求方式	POST
Content-Type	application/json

请求参数

参数名	类型	必填	说明
birth_data	Object	是	出生信息对象
birth_data.year	String	是	出生年份，例如："1990"
birth_data.month	String	是	出生月份，例如："01"
birth_data.day	String	是	出生日期，例如："15"
birth_data.hour	String	是	出生小时（24小时制），例如："15"
birth_data.minute	String	是	出生分钟，例如："30"
birth_data.second	String	是	出生秒数，例如："00"
birth_data.latitude	String	是	出生地纬度，例如："39.90"
birth_data.longitude	String	是	出生地经度，例如："116.40"
birth_data.timezone_offset	String	是	时区偏移，例如："8"（东八区）
target_date	String	是	需要分析的目标日期，格式为"YYYY-MM-DD"，例如："2025-06-27"

请求示例

{
    "birth_data": {
        "year": "1949",
        "month": "06",
        "day": "22",
        "hour": "15",
        "minute": "08",
        "longitude": "116.40",
        "second": "00",
        "latitude": "39.90",
        "timezone_offset": "8"
    },
    "target_date": "2025-06-27"
}

返回参数

参数名	类型	说明
date	String	分析的目标日期
aspects	Array	行星相位列表，包含当日发生的各种行星相位及其解读
important_aspect	Object	当日最重要的相位及其影响详情
scores	Object	各领域的运势评分（0-100分）

相位参数详情

参数名	类型	说明
aspect_type	String	相位类型，例如："0"（合相）、"180"（对冲）、"90"（刑相）等
nplanet	String	本命行星
tplanet	String	行运行星
content	String	相位的详细解读
key	String	相位的关键词概括
start_time	String	相位影响开始日期
exact_time	String	相位精确发生日期
end_time	String	相位影响结束日期
is_exact	Boolean	是否在当天精确成相

重要相位详情

参数名	类型	说明
aspect_type	String	相位类型
nplanet	String	本命行星
tplanet	String	行运行星
is_exact	Boolean	是否精确
main_field	String	主要影响领域，如"love"、"career"、"health"等
influence_value	Number	影响程度（1-5）
one	String	一句话概括
d1, d2, d3	String	建议操作
nd1, nd2, nd3	String	提醒注意事项

运势评分详情

参数名	类型	说明
love	Number	爱情运势评分（0-100）
career	Number	事业运势评分（0-100）
wealth	Number	财富运势评分（0-100）
health	Number	健康运势评分（0-100）
study	Number	学习运势评分（0-100）

返回示例

{
    "aspects": [
        {
            "aspect_type": "0",
            "content": "",
            "end_time": "2025-06-30",
            "exact_time": "2025-06-27",
            "is_exact": true,
            "key": "",
            "nplanet": "House9",
            "start_time": "2025-06-24",
            "tplanet": "Sun"
        },
        {
            "aspect_type": "180",
            "content": "在这段时期中，你有时会感到积极，但可能会遇到一些障碍，你必须克服才能真正从中受益。你自然倾向于对他人友善，乐于伸出援手，心怀宽容。然而，这种帮助应该来自于你自己的意愿，而不是他人施加的义务感。你对个人自由的渴望在这段时间里增强，当你感到无拘无束时，你更有可能在旁人眼中表现出责任感。任何试图控制或限制你的尝试都会遭到抵抗，因为你重视自己的独立性。这种倾向也延伸到你的关系中；如果你的伴侣变得占有欲强或试图束缚你，你会反抗，可能会导致关于你对自主权需要的分歧。此外，这段时期可能会促使你反思生活的目的和抱负，提供有价值的见解，对你未来的决策有着巨大影响。这是一个评估和内在成长的时刻。你所发现的将对你意义重大。",
            "end_time": "2025-06-27",
            "exact_time": "2025-06-27",
            "is_exact": true,
            "key": "积极但障碍",
            "nplanet": "Jupiter",
            "start_time": "2025-06-27",
            "tplanet": "Moon"
        },
        {
            "aspect_type": "180",
            "content": "在这段时间里，你可能会感到乐观和积极，这是进行谈判和讨论的好时机。不过要小心，因为你可能会被大想法所迷惑，从而忽略重要的细节。在处理所有事务时要注意细节，并充分考虑各个方面。保持对不同观点的开放，避免表现得傲慢或自以为是。参与友好的辩论，但不要太过认真。通过仔细考虑，你可以做出明智的判断，成功推动你的计划。",
            "end_time": "2025-06-29",
            "exact_time": "2025-06-27",
            "is_exact": true,
            "key": "乐观谈判",
            "nplanet": "Jupiter",
            "start_time": "2025-06-26",
            "tplanet": "Mercury"
        }
    ],
    "date": "2025-06-27",
    "important_aspect": {
        "aspect_type": "180",
        "d1": "耐心点",
        "d2": "留白",
        "d3": "多交流",
        "influence_value": 2.5,
        "is_exact": true,
        "main_field": "love",
        "nd1": "急躁",
        "nd2": "被控制",
        "nd3": "无底线",
        "nplanet": "Jupiter",
        "one": "你现在的能量很正向，但为了真正成长必须克服障碍。保持独立和反思，以获得个人与关系的和谐。",
        "tplanet": "Moon"
    },
    "scores": {
        "career": 70,
        "health": 70,
        "love": 68,
        "study": 62,
        "wealth": 68
    }
}

使用说明

注意事项：

target_date参数需符合YYYY-MM-DD格式
birth_data中的所有时间参数都应该使用24小时制
经纬度坐标需要使用小数点格式
时区偏移为相对于GMT的小时差，东区为正数，西区为负数
每次请求返回特定日期的运势分析，如需获取一段时间的运势，需多次调用

错误代码

错误代码	说明	解决方案
INVALID_BIRTH_DATA	提供的出生信息无效	检查出生日期和时间是否正确
INVALID_TARGET_DATE	提供的目标日期无效	确保target_date格式为"YYYY-MM-DD"
CALCULATION_ERROR	运势计算出错	请联系客服支持