AstroWay/api v2.260.0 · pt
todos os sistemas normais
// astrology api · POST /v1/chinese/zodiac/compatibility

API de compatibilidade do zodíaco chinês

Duas datas de nascimento entram, uma correspondência pontuada sai, construída sobre a geometria dos doze ramos em vez de uma tabela de opiniões. O animal do ano é resolvido no instante exato de Li Chun, então um nascimento em fevereiro cai no animal a que realmente pertence.

Endpoint
POST /v1/chinese/zodiac/compatibility
Custo
10 créditos
Latência
~60 ms
Nível
Tier 1
// 01 / O que calcula

API de compatibilidade do zodíaco chinês

Cada data é resolvida para o seu ano solar, que começa no instante de Li Chun tirado das efemérides em vez de 1 de janeiro ou do Ano Novo Chinês. Esse ano dá o ramo terrestre e o seu animal. A pontuação então lê a relação entre os dois ramos: os trígonos 三合, que agrupam quatro conjuntos de três ramos espaçados uniformemente ao redor do círculo, e os choques 六冲, que associam cada ramo com o diretamente oposto. As relações vizinhas e neutras ficam entre eles. A resposta retorna ambos os animais resolvidos, uma pontuação numérica, uma categoria e uma nota curta explicando o que o par significa, para que uma UI possa mostrar o veredito sem uma segunda tabela de consulta.

// 02 / Pedido ao vivo

POST/v1/chinese/zodiac/compatibility

curl -X POST https://api.astroway.info/v1/chinese/zodiac/compatibility \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "person1": { "date": "1990-05-15" },
    "person2": { "date": "1988-02-20" }
  }'
Resposta (excerto)
{
  "ok": true,
  "data": {
    "person1": { "solarYear": 1990, "animal": "Horse" },
    "person2": { "solarYear": 1988, "animal": "Dragon" },
    "compatibility": {
      "score": 65,
      "category": "good",
      "notes": ["Compatible enough; complementary differences."]
    }
  }
}
// 03 / Parâmetros

Parâmetros

nametypeObrigatório
person1.date string (YYYY-MM-DD) sim First birth date. The animal comes from the solar year, which opens at Li Chun, not at New Year.
person2.date string (YYYY-MM-DD) sim Second birth date.
person1.time string (HH:MM:SS) não Only matters for a birth within a day of Li Chun, where the hour decides the year.
person1.timezoneOffset number (hours) não The UTC offset the clock was on. Used with time to place a boundary birth.
person1.solarYear number não Override the resolved year outright when you already hold it.
language string não Any of 21 codes. Adds animalName next to the English token; the English fields do not move.
// 04 / Quando usar

Quando usar

Recorra a ele quando quiser um sinal rápido e barato de compatibilidade ligado apenas a uma data: um filtro de correspondência, um cartão partilhável, um quiz, um widget de marketing, um passo de integração onde pedir a hora de nascimento custaria-lhe a conversão. É a leitura mais grosseira do catálogo e é honesta sobre isso, pois um animal do ano conhece exatamente um carácter das oito de uma pessoa. Quando o produto justifica uma leitura real, pegue o gráfico completo de BaZi para ambas as pessoas e olhe para as interações através dos quatro pilares em vez disso.

// 05 / Notas

Notas

A pontuação é derivada da doutrina canónica 三合 e 六冲, não de uma matriz de opinião escrit à mão, é por que é reprodutível e explica-se. Um nascimento dentro de um dia de Li Chun é o único caso em que a hora importa: passe a hora e o timezoneOffset e o limite é resolvido ao segundo. Os nomes dos animais traduzem-se para 21 línguas; o token inglês fica no lugar.

Experimente a API de Compatibilidade do zodíaco chinês

Obtenha uma chave e faça a sua primeira chamada em menos de um minuto.

99.9% SLA · planos pagos · 30d status →