API de compatibilidad del zodiaco chino
Dos fechas de nacimiento de entrada, una puntuación de compatibilidad de salida, construida sobre la geometría de las doce ramas en lugar de una tabla de opiniones. El animal del año se determina en el instante exacto de Li Chun, por lo que un nacimiento en febrero corresponde al animal que realmente le pertenece.
API de compatibilidad del zodiaco chino
Cada fecha se resuelve a su año solar, que comienza en el instante de Li Chun tomado de las efemérides en lugar del 1 de enero o del Año Nuevo Chino. Ese año da la rama terrenal y su animal. La puntuación luego lee la relación entre las dos ramas: los 三合 trígonos, que agrupan cuatro conjuntos de tres ramas espaciadas uniformemente alrededor del círculo, y los 六冲 choques, que emparejan cada rama con la directamente opuesta. Las relaciones vecinas y neutras caen en el medio. La respuesta devuelve ambos animales resueltos, una puntuación numérica, una categoría y una breve nota explicando lo que significa la pareja, para que una interfaz de usuario pueda mostrar el veredicto sin una segunda tabla de búsqueda.
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" }
}' {
"ok": true,
"data": {
"person1": { "solarYear": 1990, "animal": "Horse" },
"person2": { "solarYear": 1988, "animal": "Dragon" },
"compatibility": {
"score": 65,
"category": "good",
"notes": ["Compatible enough; complementary differences."]
}
}
} Parámetros
| name | type | Obligatorio | |
|---|---|---|---|
| person1.date | string (YYYY-MM-DD) | sí | 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) | sí | Second birth date. |
| person1.time | string (HH:MM:SS) | no | Only matters for a birth within a day of Li Chun, where the hour decides the year. |
| person1.timezoneOffset | number (hours) | no | The UTC offset the clock was on. Used with time to place a boundary birth. |
| person1.solarYear | number | no | Override the resolved year outright when you already hold it. |
| language | string | no | Any of 21 codes. Adds animalName next to the English token; the English fields do not move. |
Cuándo usarlo
Úsalo cuando quieras una señal de compatibilidad rápida y barata basada solo en una fecha: un filtro de emparejamiento, una tarjeta compartible, un cuestionario, un widget de marketing, un paso de incorporación donde pedir la hora de nacimiento te costaría la conversión. Es la interpretación más gruesa del catálogo y es honesta al respecto, ya que un animal de año conoce exactamente un carácter de las ocho de una persona. Cuando el producto lo justifica, toma el gráfico completo BaZi para ambas personas y mira las interacciones en los cuatro pilares en su lugar.
Notas
La puntuación se deriva de la doctrina canónica de 三合 y 六冲, no de una matriz de opinión escrita a mano, por lo que es reproducible y se explica a sí misma. Un nacimiento dentro de un día de Li Chun es el único caso donde la hora importa: pasa la hora y el timezoneOffset y el límite se resuelve al segundo. Los nombres de los animales se traducen a 21 idiomas; el token inglés permanece en su lugar.
Prueba la API de Compatibilidad del zodiaco chino
Consigue una clave y haz tu primera llamada en menos de un minuto.