AstroWay/api v2.260.0 · pt
todos os sistemas normais
// astrology api · POST /v1/ziwei/chart

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.

Endpoint
POST /v1/ziwei/chart
Custo
20 créditos
Latência
~130 ms
Nível
Tier 2
// 01 / O que calcula

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.

// 02 / Pedido ao vivo

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
  }'
Resposta (excerto)
{
  "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 }
      }
    ]
  }
}
// 03 / Parâmetros

Parâmetros

nametypeObrigató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.
// 04 / Quando usar

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.

// 05 / Notas

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.

99.9% SLA · planos pagos · 30d status →