Zi Wei Dou Shu (Estrela Púrpura) API
Uma data de nascimento, uma hora e um sexo geram o gráfico completo: doze palácios com os seus troncos, todas as catorze estrelas principais, as auxiliares, trinta e uma estrelas menores, as doze fases da vida, os limites de década e as quatro transformações marcadas nas estrelas que as carregam.
Zi Wei Dou Shu (Estrela Púrpura) API
O nascimento é convertido para uma data lunar, porque Zi Wei é um sistema puramente lunar e, ao contrário de BaZi, não passa para os termos solares. A partir do mês lunar e da double-hour o endpoint coloca o palácio da alma e o palácio do corpo, depois aplica a regra dos cinco tigres a cada palácio, depois lê a classe dos cinco elementos do pilar do palácio da alma. Essa classe e o dia lunar posicionam 紫微 segundo a regra clássica de emprestar e dividir, as seis estrelas da sua série seguem com offsets fixos, 天府 espelha-a ao longo do eixo 寅-申 e traz as suas próprias oito. Sobre esse esqueleto vão as seis estrelas de sorte e as seis estrelas maléficas, o depósito salarial e o cavalo celestial, trinta e uma estrelas menores ligadas ao tronco do ano, ao ramo do ano, ao mês, ao dia e à hora, as doze fases da vida, o ciclo do estudioso, o ciclo geral e o ciclo do ano, os limites de dez anos que se abrem no número da classe, e o limite anual se pedires a idade. As quatro transformações são resolvidas a partir do year stem e anexadas às próprias estrelas em vez de serem devolvidas como lista separada.
POST/v1/ziwei/chart
curl -X POST https://api.astroway.info/v1/ziwei/chart \
-H "X-Api-Key: aw_live_..." \
-H "Content-Type: application/json" \
-d '{
"date": "2000-08-16",
"time": "04:00:00",
"gender": "male",
"age": 25
}' {
"ok": true,
"data": {
"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" }],
"lifeStage": { "chinese": "死", "name": "Death" },
"decade": { "index": 0, "fromAge": 3, "toAge": 12 }
}
]
}
} Parâmetros
| name | type | Obrigatório | |
|---|---|---|---|
| date | string (YYYY-MM-DD) | sim | Birth date. It is converted to a lunar date, because Zi Wei is a lunar system. |
| time | string (HH:MM:SS) | sim | Local clock time. Required: the soul palace is placed from the double-hour, so a chart without it would be twelve palaces of confident nonsense rather than a partial answer. |
| gender | string | sim | male or female. It sets the direction of the twelve life stages, the scholar cycle and the decade limits, so the chart cannot be built without it. |
| age | number | não | Return the annual-limit palace for this age. Omit and the field comes back null. |
| yearDivide | string | não | lunar (default: the year opens on day one of the first lunar month) or lichun (the BaZi boundary, for reconciling against a calculator that imported it). |
| fixLeap | boolean | não | Split a leap month at day 15 (default) or count the whole of it as the month it follows. |
| dayDivide | string | não | forward (default: 23:00 belongs to the next day) or current (keep the date and mark the hour as the late Zi). |
| school | string | não | The 四化 table: zhongzhou (default), quanji, quanshu or beipai. The four disagree on three of the ten year stems. |
| language | string | não | Any of 21 codes. Palace names and life-stage names come back translated; star names stay as characters with an English gloss. |
Quando usar
Usa-o quando estiveres a criar um produto de astrologia chinesa para um mercado que lê algo que não seja chinês: uma app, um serviço de leituras, um renderizador de gráficos, um agente que precisa da estrutura antes de interpretar. A resposta é pura estrutura sem prosa, por isso encaixa-se num grid de doze palácios, num gerador de relatórios ou num prompt de LLM da mesma forma. Os endpoints de referência na mesma família são mais baratos e úteis para glossários e tooltips, mas devolvem a mesma tabela para cada nascimento e indicam isso num campo, por isso não construas um gráfico a partir deles.
Notas
Fixado a três gráficos publicados em vez de a uma única biblioteca, a propósito: quase todo o ecossistema open-source Zi Wei descende de um único projeto, por isso concordar com vários deles é concordar com um. Dois gráficos completos reproduzem-se exatamente, e um terceiro vem de um texto de ensino não relacionado. Quatro comutadores de escola vivem no corpo da requisição em vez de no nosso código, porque cada um move o gráfico inteiro para os nascimentos que toca: o limite do ano, o mês bissexto, a passagem das 23:00 e a tabela de transformações. Quando outro calculador discordar, verifica esses quatro antes da aritmética.
Experimente a API de Zi Wei Dou Shu
Obtenha uma chave e faça a sua primeira chamada em menos de um minuto.