Numerologia

Calcula perfis numerológicos incluindo números de caminho de vida, expressão, impulso da alma, personalidade e compatibilidade.

Módulo Necessário

Todos os endpoints de numerologia requerem que o módulo module:numerology esteja activado para a tua organização.

Perfil Completo

Calcula um perfil numerológico completo para uma pessoa com base na data de nascimento e nome completo:

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();

Parâmetros

Parâmetro	Tipo	Obrigatório	Descrição
`dateTime`	string	Sim	Data e hora de nascimento no formato `YYYY-MM-DDTHH:mm`
`fullName`	string	Sim	Nome completo ao nascer (conforme no registo de nascimento)
`language`	string	Não	Código de idioma para o texto de interpretação (padrão: `"en"`)
`includeText`	boolean	Não	Incluir texto de interpretação (padrão: `false`)

Resposta

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]
    }
}

Objecto NumerologyNumber

Campo	Tipo	Descrição
`value`	number	O número numerológico final
`isMasterNumber`	boolean	Se é um número mestre (11, 22, 33)
`isKarmicDebt`	boolean	Se é um número de dívida kármica (13, 14, 16, 19)
`reducedFrom`	number	O número antes da redução final
`calculation`	string	Explicação passo a passo do cálculo
`text`	string \| null	Texto de interpretação (apenas se `includeText: true`)

Número do Caminho de Vida

Calcula o número do caminho de vida a partir de uma data de nascimento:

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
  }'

Parâmetros

Parâmetro	Tipo	Obrigatório	Descrição
`dateTime`	string	Sim	Data e hora de nascimento no formato `YYYY-MM-DDTHH:mm`
`language`	string	Não	Código de idioma para o texto de interpretação
`includeText`	boolean	Não	Incluir texto de interpretação

Número de Expressão

Calcula o número de expressão a partir de um nome completo usando numerologia pitagórica:

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
  }'

Parâmetros

Parâmetro	Tipo	Obrigatório	Descrição
`fullName`	string	Sim	Nome completo ao nascer
`language`	string	Não	Código de idioma para o texto de interpretação
`includeText`	boolean	Não	Incluir texto de interpretação

Número do Impulso da Alma

Calcula o número do impulso da alma (desejo do coração) a partir das vogais do nome:

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"
  }'

Número da Personalidade

Calcula o número da personalidade a partir das consoantes do nome:

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"
  }'

Número do Dia de Nascimento

Calcula o número do dia de nascimento a partir do dia de nascimento:

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"
  }'

Ciclos Pessoais

Calcula ciclos de ano, mês e dia pessoais para timing e planeamento:

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"
  }'

Parâmetros

Parâmetro	Tipo	Obrigatório	Descrição
`dateTime`	string	Sim	Data e hora de nascimento no formato `YYYY-MM-DDTHH:mm`
`currentDate`	string	Não	Data de referência no formato `YYYY-MM-DD` (padrão: hoje)

Resposta

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
        }
    }
}

Compatibilidade

Calcula a compatibilidade numerológica entre duas pessoas com base nos seus números de caminho de vida:

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();

Parâmetros

Parâmetro	Tipo	Obrigatório	Descrição
`dateTime1`	string	Sim	Data e hora de nascimento da primeira pessoa no formato `YYYY-MM-DDTHH:mm`
`dateTime2`	string	Sim	Data e hora de nascimento da segunda pessoa no formato `YYYY-MM-DDTHH:mm`

Resposta

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..."
    }
}

Classificações de Compatibilidade

Classificação	Intervalo de Pontuação	Descrição
`"excellent"`	85–100	Números de caminho de vida altamente compatíveis
`"good"`	65–84	Boa compatibilidade com energias complementares
`"moderate"`	45–64	Compatibilidade moderada, requer compreensão
`"challenging"`	0–44	Dinâmica desafiante, crescimento através do contraste

Números Mestres

Os números mestres (11, 22, 33) não são reduzidos mais no cálculo padrão. Transportam energia e significância amplificadas.

Números Mestres

Quando um cálculo resulta em 11, 22 ou 33, o sinalizador isMasterNumber é definido como true e o valor é mantido tal como está. O campo reducedFrom será igual ao value neste caso.

Números de Dívida Kármica

Os números de dívida kármica (13, 14, 16, 19) indicam lições carregadas de vidas passadas. Quando presentes, o sinalizador isKarmicDebt é definido como true.

Número Kármico	Reduzido Para	Tema
13	4	Trabalho árduo e disciplina
14	5	Uso responsável da liberdade
16	7	Rendição do ego e crescimento espiritual
19	1	Independência e auto-suficiência

Numerologia ​

Perfil Completo ​

Parâmetros ​

Resposta ​

Objecto NumerologyNumber ​

Número do Caminho de Vida ​

Parâmetros ​

Número de Expressão ​

Parâmetros ​

Número do Impulso da Alma ​

Número da Personalidade ​

Número do Dia de Nascimento ​

Ciclos Pessoais ​

Parâmetros ​

Resposta ​

Compatibilidade ​

Parâmetros ​

Resposta ​

Classificações de Compatibilidade ​

Números Mestres ​

Números de Dívida Kármica ​

Numerologia

Perfil Completo

Parâmetros

Resposta

Objecto NumerologyNumber

Número do Caminho de Vida

Parâmetros

Número de Expressão

Parâmetros

Número do Impulso da Alma

Número da Personalidade

Número do Dia de Nascimento

Ciclos Pessoais

Parâmetros

Resposta

Compatibilidade

Parâmetros

Resposta

Classificações de Compatibilidade

Números Mestres

Números de Dívida Kármica