九宫格计算API文档

接口说明

九宫格计算接口提供完整的占星图表分析，包括行星位置、宫位系统以及全面的运势解读。该接口还提供各方面能力的分数评估和个性解读。

基本信息

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

请求参数

参数名 类型 必填 说明
year String 是 出生年份，例如："1990"
month String 是 出生月份，例如："01"
day String 是 出生日期，例如："15"
hour String 是 出生小时（24小时制），例如："15"
minute String 是 出生分钟，例如："30"
second String 是 出生秒数，例如："00"
latitude String 是 出生地纬度，例如："39.90"
longitude String 是 出生地经度，例如："116.40"
timezone String 是 时区，例如："8"（东八区）

请求示例

{
    "year": "1949",
    "month": "06",
    "day": "22",
    "hour": "15",
    "minute": "08",
    "second": "00",
    "longitude": "116.40",
    "latitude": "39.90",
    "timezone": "8"
}

返回参数

参数名 类型 说明
basic_info Object 基本信息，包含日期、时间、地理位置和时区
houses Object 宫位信息，包含12宫的度数、黄道位置和星座
planets Object 行星位置信息，包含主要天体和小行星的度数、宫位和星座
interpretations Object 星盘解读信息，包含各类评分和性格特点的详细解读

解读内容详情

解读内容包括以下几个主要部分：

类型 说明
oneword_interpretation 一句话概括性格特点
planet_positions_interpretation 主要行星位置的详细解读，包含在不同星座的表现特质
signcode_interpretation 星座密码解读，包括表层自我、真实自我和隐藏技能
tianming_interpretation 天命解读，揭示个人最大的天赋和使命
各项评分 包括爱情、事业、财富和社交能力的评分（0-100分）

返回示例

{
    "basic_info": {
        "date": "1949-06-22",
        "latitude": "39.9",
        "longitude": "116.4",
        "time": "15:08:00",
        "timezone": "+8:00"
    },
    "houses": {
        "House1": {
            "degree": 4.6196139175214626,
            "lon": 214.61961391752146,
            "sign": "Scorpio"
        },
        // 其他宫位数据...
    },
    "planets": {
        "Sun": {
            "degree": 0.5203783987277717,
            "house": 8,
            "lon": 90.52037839872777,
            "sign": "Cancer"
        },
        // 其他行星数据...
    },
    "interpretations": {
        "oneword_interpretation": "安稳中藏着小确幸，享受生活的治愈系。",
        "planet_positions_interpretation": [
            {
                "content": "你心思敏锐，擅长观察，总能轻易洞悉他人的心思，成为大家情感倾诉的首选...",
                "degree": 0.5203783987277717,
                "interpretation_key": "温情观察者",
                "planet": "太阳",
                "zodiac": "巨蟹座"
            },
            // 其他行星解读...
        ],
        "signcode_interpretation": [
            {
                "content": "眼神杀的代言人",
                "degree": 4.6196139175214626,
                "planet": "Asc",
                "type": "surface_me",
                "zodiac": "天蝎座"
            },
            // 其他星座密码解读...
        ],
        "tianming_interpretation": [
            {
                "content": "沟通能力超群，语言表达精准优雅",
                "degree": 10.18537608565893,
                "key": "表达大师",
                "planet": "Mercury",
                "zodiac": "双子座"
            }
        ],
        "love_score": {
            "score": 72
        },
        "career_score": {
            "score": 60
        },
        "wealth_score": {
            "score": 72
        },
        "social_score": {
            "score": 89
        }
    }
}

使用说明

注意事项：

  • 所有时间参数都应该使用24小时制
  • 经纬度坐标需要使用小数点格式，例如"116.40"而非"116度40分"
  • 时区参数为相对于GMT的小时差，东区为正数，西区为负数
  • 返回的行星位置使用黄道坐标系统

错误代码

错误代码 说明 解决方案
INVALID_DATE 提供的日期无效 检查日期参数是否正确，例如月份应为01-12
INVALID_TIME 提供的时间无效 检查时间参数是否正确，例如小时应为00-23
INVALID_LOCATION 提供的地理位置无效 检查经纬度是否在有效范围内，纬度-90到90，经度-180到180
INVALID_TIMEZONE 提供的时区无效 检查时区是否在-12到+14的范围内