POST/api/astro/numerology/chinese/1 crédito

Numerologia chinesa

Numerologia chinesa: a grade Lo Shu e os cinco elementos. `loshu_grid_arrows` lê as setas de força e de ausência na grade 3×3 dos dígitos da data de nascimento; `five_element_balance` informa Wood, Fire, Earth, Metal e Water como contagens e porcentagens. Os números de sorte e de azar seguem a tradição dos homófonos — o 8 para a prosperidade; o 4 é evitado. `house_number` e `phone_number` reduzem um número que você fornece. Se você os omitir, o padrão dos dois é 0, e a chamada funciona mesmo assim. Retorna 9 cálculos. Envie um nome e uma data de nascimento. O sistema é fixado pela rota, então um campo `system` no corpo da requisição é ignorado — este endpoint não pode retornar números de outro sistema. O endpoint pai /api/astro/numerology/ reúne todos os 34 cálculos sob um campo `system`, e pedir uma chave que pertence a outro sistema retorna um 400 que faz falhar a requisição INTEIRA. Estas rotas eliminam isso: cada uma pede apenas as chaves que seu próprio sistema suporta.

https://api.occultapi.com/api/astro/numerology/chinese/

Testar requisição

Autenticação

Envie sua chave no cabeçalho X-API-Key. A chave é uma credencial de servidor — nunca a coloque no JavaScript do navegador nem num app mobile.

X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/json

Campos da requisição

Campo	Tipo	Obrigatório	Observações
date_time	string (date-time)	obrigatório	O momento a calcular, em ISO 8601. SEMPRE inclua um deslocamento ou um Z no final - um valor sem fuso horário é lido como Asia/Kolkata (UTC+05:30), não como UTC, e pode retornar o resultado do dia anterior com um 200. '2026-09-01T06:00:00Z' e '2026-09-01 06:00:00' são instantes diferentes e dão respostas diferentes.
name	string	obrigatório
day	integer	opcional	Dia do mês como número, de 1 a 31.
house_number	string	opcional
keys	array	opcional	Quais cálculos retornar, como uma lista de nomes. Veja a tabela de chaves deste endpoint; um nome não reconhecido rejeita a requisição inteira. Uma chamada custa um crédito, não importa quantas chaves você peça, então solicite tudo o que precisa de uma vez em vez de fazer várias chamadas.
month	integer	opcional	Mês de nascimento como número, 1-12. Janeiro é 1.
phone_number	string	opcional
system	string	opcional
year	integer	opcional	Ano de nascimento como número, por exemplo 1990. Quatro dígitos.

Exemplo de requisição

curl -X POST https://api.occultapi.com/api/astro/numerology/chinese/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date_time":"1990-08-15T10:30:00+05:30","name":"Ajeet Kumar","day":15,"month":8,"year":1990}'

Resposta

{
  "data": {
    "chinese_name_number": 5,
    "five_element_balance": {
      "balance": {
        "Wood": {
          "count": 0,
          "percentage": 0,
          "meaning": "Growth, creativity, flexibility",
          "associated_numbers": [
            3,
            4
          ]
        },
        "Fire": {
          "count": 2,
          "percentage": 25,
          "meaning": "Passion, energy, transformation",
          "associated_numbers": [
            9
          ]
        },
        "Earth": {
          "count": 3,
          "percentage": 37.5,
          "meaning": "Stability, nourishment, groundedness",
          "associated_numbers": [
            2,
            5,
            8
          ]
        },
        "Metal": {
          "count": 1,
          "percentage": 12.5,
          "meaning": "Strength, determination, clarity",
          "associated_numbers": [
            6,
            7
          ]
        },
        "Water": {
          "count": 2,
          "percentage": 25,
          "meaning": "Wisdom, flow, adaptability",
          "associated_numbers": [
            1
          ]
        }
      },
      "interpretation": "The Five Elements show the distribution of energy in your chart. Wood represents growth, Fire is passion, Earth is stability, Metal represents strength, and Water represents wisdom."
    },
    "house_number": 0,
    "loshu_grid_arrows": {
      "arrow_of_determination": {
        "present": true,
        "meaning": "Indicates strong willpower and determination."
      },
      "arrow_of_emotional_balance": {
        "present": false,
        "meaning": "Indicates emotional stability and balance."
      },
      "arrow_of_practicality": {
        "present": false,
        "meaning": "Indicates a practical and grounded approach to life."
      },
      "arrow_of_intellect": {
        "present": false,
        "meaning": "Indicates strong intellectual capabilities and memory."
      }
    },
    "lucky_numbers": [
      2,
      3,
      6,
      7,
      8,
      9
    ],
    "personal_life_path_number": 6,
    "phone_number": 0,
    "unlucky_numbers": [
      1,
      4,
      5,
      6
    ],
    "vedic_personal_day": 2
  },
  "status": 200,
  "is_error": false,
  "message": "successful"
}

Capturada de uma chamada real, com exatamente a requisição acima. Os resultados ficam em data.

Erros

Erros de consumo de créditos retornam { "error": "…", "message": "<code>", "is_error": true }. Mostre error para o usuário e use message para decidir o que fazer no código. Consulte a referência de erros.