Zi Wei Dou Shu: a disposição das estrelas

Zi Wei Dou Shu constrói um mapa não a partir de planetas, mas de doze palácios e mais de cem estrelas, dispostos de acordo com as regras da data lunar e da hora de nascimento. POST /v1/ziwei/chart calcula isso na íntegra.

Endpoints

Endpoint	Créditos	O que retorna
POST /v1/ziwei/chart	20	Mapa completo: palácios, estrelas, estágios, limites, 四化. Requer time e gender
POST /v1/ziwei/four-transformations	10	四化 pelo tronco do ano, quatro escolas
POST /v1/ziwei/twelve-palaces	5	Referência dos doze palácios
POST /v1/ziwei/main-stars	5	Referência das catorze estrelas principais
POST /v1/ziwei/palace-*	5	Referência de um palácio, nove caminhos

As rotas de referência contêm o campo computed: false e custam metade da tarifa. Elas retornam a mesma tabela para qualquer data de nascimento, e não há nada de errado nisso, desde que seja indicado.

`/ziwei/full-chart` descontinuado

Ele retorna o mesmo dicionário de palácios para qualquer pessoa, e o seu nome promete um mapa. Responde sem alterações até 2027-11-26, contém os cabeçalhos Deprecation, Sunset e Link para o sucessor. Transita para /v1/ziwei/chart: ele requer gender adicionalmente à data e hora.

Exemplo

curl -X POST https://api.astroway.info/v1/ziwei/chart \
  -H "X-Api-Key: $ASTROWAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"2000-08-16","time":"04:00:00","gender":"male","age":25}'

{
  "fiveElementClass": { "key": "wood3", "chinese": "木三局", "name": "Wood 3", "value": 3 },
  "soulPalace": { "index": 4, "branch": "Wu" },
  "bodyPalace": { "index": 8, "branch": "Xu" },
  "ziwei": { "index": 4, "branch": "Wu" },
  "annualLimit": { "age": 25, "index": 8, "branch": "Xu" },
  "palaces": [
    {
      "branch": "Wu",
      "pillar": "Ren-Wu",
      "palace": "destiny",
      "isSoul": true,
      "majorStars": [{ "chinese": "紫微", "name": "Purple Star", "pinyin": "Zi Wei", "kind": "major" }],
      "lifeStage": { "chinese": "死", "name": "Death", "localised": "Death" },
      "boshi": "伏兵",
      "decade": { "index": 0, "fromAge": 3, "toAge": 12 }
    }
  ]
}

O array palaces contém todos os doze no mesmo formato, de 寅 a 丑.

O que é calculado

Passo	Regra
命宮 e 身宮	Do palácio do mês, para trás pelas horas para a Vida, para a frente para o Corpo
Troncos dos palácios	五虎遁 do tronco do ano
五行局	Do pilar do palácio da Vida; coincide com 納音 em todos os sessenta pares
紫微	Divisão do dia pelo número 局 com empréstimo: empréstimo par para a frente, ímpar para trás
紫微系 (6)	Deslocamento −1, −3, −4, −5, −8 de 紫微
天府系 (8)	天府 é o espelho de 紫微 em torno do eixo 寅-申, depois +1..+6 e +10 para 破軍
六吉 e 六煞	Do mês, da hora e do tronco do ano, cada um com a sua fórmula
Trinta e uma estrelas menores	Do ramo do ano, tronco do ano, mês, dia e hora
長生十二神	De 五行局, para a frente para 陽男陰女 e para trás caso contrário
博士十二神	De 祿存, a mesma direção
將前 e 歲前 十二神	Do trio do ramo do ano e do próprio ramo, ambos sempre para a frente
大限	De 命宮, início na idade do número 局, passo de dez anos
小限	Lê o sexo e não lê yin-yang, ao contrário dos decenais
四化	Pelo tronco do ano, marcados diretamente nas estrelas

Quatro seletores de escola

Eles estão no corpo do pedido, e não no nosso código, porque cada um deles desloca o mapa completamente para os nascimentos que afeta.

Parâmetro	Por padrão	Segundo valor
yearDivide	lunar: o ano começa no primeiro dia do primeiro mês lunar	lichun: limite de BaZi
fixLeap	true: o mês bissexto é dividido pelo décimo quinto dia	false: todo o mês bissexto é contado como o anterior
dayDivide	forward: 23:00 pertence ao dia seguinte	current: a data permanece, a hora é marcada como 晚子時
tianmaSchool	year: 天馬 do ramo do ano (中州派)	month: 天馬 do mês lunar
school	zhongzhou: 四化 pelo corpo de 王亭之	quanji, quanshu, beipai

Hora de nascimento obrigatória

O Palácio da Vida é determinado pela hora, e dele dependem o 五行局 e cada estrela. Um mapa sem hora não seria uma resposta parcial, mas doze palácios de um disparate certo, por isso um pedido sem time é rejeitado com 400. Isso difere de BaZi, onde sem a hora simplesmente não há pilar da hora.

Tempo solar verdadeiro

Por padrão, a hora é lida pelo relógio local, como a maioria dos praticantes a lê. Passa trueSolarTime: true juntamente com longitude e timezoneOffset para que a hora seja lida pelo sol sobre o local de nascimento, com a mesma correção que em /v1/bazi. Em Espanha ou no oeste de França, a diferença é de 50 a 135 minutos, e isso é suficiente para que a hora mude, e com ela o Palácio da Vida e cada estrela. A correção aplica-se à hora e ao dia; com yearDivide=lichun, o limite de Lichun permanece de acordo com o relógio. O que foi aplicado é retornado em input.trueSolarTime. longitude sem trueSolarTime não altera nada, e trueSolarTime sem longitude ou timezoneOffset resulta em 400 TRUE_SOLAR_TIME_NEEDS_PLACE.

O ano aqui não começa com Lichun

Isto não é uma escolha de escola. 斗數 é um sistema puramente lunar e não transita para termos solares, ao contrário de 子平. yearDivide=lichun existe apenas para verificação com uma calculadora que importou o limite de BaZi.

Como isto foi verificado

Ancorado em três mapas publicados, e não numa única biblioteca, e isto é intencional. Quase todo o ecossistema Zi Wei de código aberto deriva de um único projeto: duas portas mais pelo menos um projeto que declara uma linha diferente, mas que internamente o invoca e analisa a saída. Portanto, a correspondência com vários projetos é uma correspondência com um.

• Dois mapas foram reproduzidos na íntegra: todas as catorze estrelas principais, 五行局, os palácios da Vida e do Corpo.
• Os doze estágios foram verificados num terceiro vetor de fixação da mesma fonte onde os doze esperados foram publicados, e não nestes dois. Os inícios das décadas foram verificados com o número de 五行局, ou seja, com a regra da qual são derivados, e não com uma publicação externa.
• O terceiro mapa foi retirado de um texto de ensino chinês sem relação com esse ecossistema e fixa o deslocamento das estrelas e a ordem dos palácios de forma independente.
• A mnemónica 安紫微星 「六五四三二／酉午亥辰丑」 e a execução publicada de 火六局 nos dias 1-15 são verificadas diretamente: são constantes da tradição, e não a implementação de alguém.

O que fazer quando a tua calculadora dá um resultado diferente

Verifica não a aritmética, mas os quatro seletores: o limite do ano, o mês bissexto, o limite do dia às 23:00 e a tabela 四化. Quase sempre a divergência está aí.

Uma interpretação comum que está errada

火星 e 鈴星 são dispostos para a frente a partir do trio do ramo do ano e não leem o sexo em nenhuma transmissão verificada. A regra 陽男陰女順 / 陰男陽女逆, que por vezes lhes é atribuída, pertence aos doze estágios 長生十二神 e aos limites decenais. Ambos os tópicos estão na mesma página na fonte mais frequentemente copiada, e parece que a confusão começou aí.

Idiomas

Os nomes dos palácios e dos doze estágios são traduzidos para 21 idiomas: adiciona ?lang=, e em cada palácio aparecerá palaceLocalised, e no estágio o campo localised. Os nomes das estrelas permanecem em ideogramas com a tradução em inglês ao lado: não têm nomes estabelecidos.