数字学

计算数字学档案，包括生命之路数、表达数、灵魂渴望数、个性数和相容性数字。

所需模块

所有数字学端点均需要为您的组织启用 module:numerology 模块。

完整档案

根据出生日期和全名为某人计算完整的数字学档案：

bash

curl -X POST "https://api.astroapi.cloud/api/numerology/profile" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "dateTime": "1990-06-15T14:30",
    "fullName": "Jane Elizabeth Smith",
    "language": "en",
    "includeText": true
  }'

javascript

const response = await fetch("https://api.astroapi.cloud/api/numerology/profile", {
    method: "POST",
    headers: {
        "X-Api-Key": "your-api-key",
        "Content-Type": "application/json"
    },
    body: JSON.stringify({
        dateTime: "1990-06-15T14:30",
        fullName: "Jane Elizabeth Smith",
        language: "en",
        includeText: true
    })
});
const data = await response.json();

参数

参数	类型	必填	描述
`dateTime`	string	是	出生日期和时间，格式为 `YYYY-MM-DDTHH:mm`
`fullName`	string	是	完整出生姓名（与出生证明上一致）
`language`	string	否	解读文本的语言代码（默认：`"en"`）
`includeText`	boolean	否	包含解读文本（默认：`false`）

响应

json

{
    "data": {
        "lifePathNumber": {
            "value": 7,
            "isMasterNumber": false,
            "isKarmicDebt": false,
            "reducedFrom": 34,
            "calculation": "1+9+9+0+0+6+1+5 = 31, 3+1 = 4... (full reduction)",
            "text": "The Life Path 7 is the path of the seeker..."
        },
        "expressionNumber": {
            "value": 11,
            "isMasterNumber": true,
            "isKarmicDebt": false,
            "reducedFrom": 11,
            "calculation": "J(1)+A(1)+N(5)+E(5)+... = 47, 4+7 = 11",
            "text": null
        },
        "soulUrgeNumber": {
            "value": 6,
            "isMasterNumber": false,
            "isKarmicDebt": false,
            "reducedFrom": 15,
            "calculation": "Vowels: A(1)+E(5)+E(5)+I(9)+... = 24, 2+4 = 6",
            "text": null
        },
        "personalityNumber": {
            "value": 5,
            "isMasterNumber": false,
            "isKarmicDebt": false,
            "reducedFrom": 23,
            "calculation": "Consonants: J(1)+N(5)+... = 23, 2+3 = 5",
            "text": null
        },
        "birthdayNumber": {
            "value": 6,
            "isMasterNumber": false,
            "isKarmicDebt": false,
            "reducedFrom": 15,
            "calculation": "Day: 15, 1+5 = 6",
            "text": null
        },
        "personalYear": {
            "value": 3,
            "isMasterNumber": false,
            "isKarmicDebt": false,
            "reducedFrom": 12,
            "calculation": "6+15+2024 reduced",
            "text": null
        },
        "personalMonth": {
            "value": 9,
            "isMasterNumber": false,
            "isKarmicDebt": false,
            "reducedFrom": 9,
            "calculation": "Personal year (3) + current month (6) = 9",
            "text": null
        },
        "personalDay": {
            "value": 4,
            "isMasterNumber": false,
            "isKarmicDebt": false,
            "reducedFrom": 13,
            "calculation": "Personal month (9) + current day (13) = 22, 2+2 = 4",
            "text": null
        },
        "karmicDebtNumbers": [13, 16],
        "masterNumbers": [11]
    }
}

NumerologyNumber 对象

字段	类型	描述
`value`	number	最终数字学数字
`isMasterNumber`	boolean	是否为主数（11、22、33）
`isKarmicDebt`	boolean	是否为业力债数（13、14、16、19）
`reducedFrom`	number	最终约简前的数字
`calculation`	string	逐步计算说明
`text`	string \| null	解读文本（仅当 `includeText: true` 时）

生命之路数

根据出生日期计算生命之路数：

bash

curl -X POST "https://api.astroapi.cloud/api/numerology/life-path" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "dateTime": "1990-06-15T14:30",
    "language": "en",
    "includeText": true
  }'

参数

参数	类型	必填	描述
`dateTime`	string	是	出生日期和时间，格式为 `YYYY-MM-DDTHH:mm`
`language`	string	否	解读文本的语言代码
`includeText`	boolean	否	包含解读文本

表达数

使用毕达哥拉斯数字学根据全名计算表达数：

bash

curl -X POST "https://api.astroapi.cloud/api/numerology/expression" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "fullName": "Jane Elizabeth Smith",
    "language": "en",
    "includeText": true
  }'

参数

参数	类型	必填	描述
`fullName`	string	是	完整出生姓名
`language`	string	否	解读文本的语言代码
`includeText`	boolean	否	包含解读文本

灵魂渴望数

根据姓名中的元音字母计算灵魂渴望（心之所愿）数：

bash

curl -X POST "https://api.astroapi.cloud/api/numerology/soul-urge" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "fullName": "Jane Elizabeth Smith"
  }'

个性数

根据姓名中的辅音字母计算个性数：

bash

curl -X POST "https://api.astroapi.cloud/api/numerology/personality" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "fullName": "Jane Elizabeth Smith"
  }'

生日数

根据出生日期计算生日数：

bash

curl -X POST "https://api.astroapi.cloud/api/numerology/birthday" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "dateTime": "1990-06-15T14:30"
  }'

个人周期

计算个人年、月、日周期，用于时机规划：

bash

curl -X POST "https://api.astroapi.cloud/api/numerology/personal-cycles" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "dateTime": "1990-06-15T14:30",
    "currentDate": "2024-06-15"
  }'

参数

参数	类型	必填	描述
`dateTime`	string	是	出生日期和时间，格式为 `YYYY-MM-DDTHH:mm`
`currentDate`	string	否	参考日期，格式为 `YYYY-MM-DD`（默认：今天）

响应

json

{
    "data": {
        "personalYear": {
            "value": 3,
            "isMasterNumber": false,
            "isKarmicDebt": false,
            "reducedFrom": 12,
            "calculation": "birth month (6) + birth day (15 → 6) + current year (2024 → 8) = 20, 2+0 = 2... reduced to 3",
            "text": null
        },
        "personalMonth": {
            "value": 9,
            "isMasterNumber": false,
            "isKarmicDebt": false,
            "reducedFrom": 9,
            "calculation": "Personal year (3) + current month (6) = 9",
            "text": null
        },
        "personalDay": {
            "value": 4,
            "isMasterNumber": false,
            "isKarmicDebt": false,
            "reducedFrom": 13,
            "calculation": "Personal month (9) + current day (15 → 6) = 15, 1+5 = 6... reduced to 4",
            "text": null
        }
    }
}

相容性

根据两人的生命之路数计算数字学相容性：

bash

curl -X POST "https://api.astroapi.cloud/api/numerology/compatibility" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "dateTime1": "1990-06-15T14:30",
    "dateTime2": "1988-03-22T09:15"
  }'

javascript

const response = await fetch("https://api.astroapi.cloud/api/numerology/compatibility", {
    method: "POST",
    headers: {
        "X-Api-Key": "your-api-key",
        "Content-Type": "application/json"
    },
    body: JSON.stringify({
        dateTime1: "1990-06-15T14:30",
        dateTime2: "1988-03-22T09:15"
    })
});
const data = await response.json();

参数

参数	类型	必填	描述
`dateTime1`	string	是	第一人的出生日期和时间，格式为 `YYYY-MM-DDTHH:mm`
`dateTime2`	string	是	第二人的出生日期和时间，格式为 `YYYY-MM-DDTHH:mm`

响应

json

{
    "data": {
        "person1LifePath": 7,
        "person2LifePath": 3,
        "compatibilityScore": 72,
        "relationship": "good",
        "description": "Life Path 7 and Life Path 3 can form a complementary partnership. The 7 brings depth and introspection while the 3 adds creativity and social energy..."
    }
}

相容性评级

评级	评分范围	描述
`"excellent"`	85–100	高度相容的生命之路数
`"good"`	65–84	具有互补能量的良好相容性
`"moderate"`	45–64	中等相容性，需要相互理解
`"challenging"`	0–44	具有挑战性的动态，通过对比实现成长

主数

主数（11、22、33）在标准计算中不进一步约简。它们携带放大的能量和意义。

主数

当计算结果为 11、22 或 33 时，isMasterNumber 标志设为 true，值保持不变。此时 reducedFrom 字段将等于 value。

业力债数

业力债数（13、14、16、19）表示来自前世的课题。当存在时，isKarmicDebt 标志设为 true。

业力数字	约简为	主题
13	4	努力工作和纪律
14	5	负责任地使用自由
16	7	放下自我与精神成长
19	1	独立与自立

数字学 ​

完整档案 ​

参数 ​

响应 ​

NumerologyNumber 对象 ​

生命之路数 ​

参数 ​

表达数 ​

参数 ​

灵魂渴望数 ​

个性数 ​

生日数 ​

个人周期 ​

参数 ​

响应 ​

相容性 ​

参数 ​

响应 ​

相容性评级 ​

主数 ​

业力债数 ​

数字学

完整档案

参数

响应

NumerologyNumber 对象

生命之路数

参数

表达数

参数

灵魂渴望数

个性数

生日数

个人周期

参数

响应

相容性

参数

响应

相容性评级

主数

业力债数