Étoiles volantes (玄空飛星)

Xuan Kong Fei Xing (玄空飛星) est une école de feng shui qui dresse un thème non pas pour une personne, mais pour un bâtiment. Deux données suffisent, et les deux sont obligatoires : la période pendant laquelle le bâtiment a été occupé et la direction vers laquelle il fait face. On en tire trois nombres pour chacun des neuf secteurs.

Trois étoiles dans chaque palais

Étoile	中文	Ce qu’on y lit
De montagne	山星	Les personnes, la santé, les relations
Étoile de la période	運星	L’époque à laquelle appartient le bâtiment
De façade	向星	L’argent, les opportunités, le mouvement

Le nombre d’une étoile et son vol relèvent de l’arithmétique exacte. Ce que signifie une paire de nombres dans une pièce donnée relève déjà d’une tradition d’interprétation, qui compte plus d’une école. La réponse sépare ces deux moitiés, et notes indique où s’arrête le calcul.

Endpoints

Endpoint	Crédits	Ce qu’il renvoie
POST /v1/chinese/feng-shui/flying-star	10	Thème natal du bâtiment : neuf palais, type de thème, configurations particulières
POST /v1/chinese/feng-shui/annual-stars	10	Étoiles annuelles et afflictions de l’année, avec une couche mensuelle en option

Attention

La période n’a pas de valeur par défaut. Sans period ni occupiedDate, la requête renvoie 400. Un bâtiment occupé en 1998 appartient à la période 7, et un thème de période 9 présenté avec assurance serait pour lui simplement une mauvaise réponse qui a l’air juste.

Exemple

cURL

curl -X POST https://api.astroway.info/v1/chinese/feng-shui/flying-star \
  -H "X-Api-Key: aw_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{ "period": 8, "facing": 180, "year": 2026 }'

Node

const res = await fetch('https://api.astroway.info/v1/chinese/feng-shui/flying-star', {
  method: 'POST',
  headers: { 'X-Api-Key': process.env.ASTROWAY_KEY, 'Content-Type': 'application/json' },
  body: JSON.stringify({ occupiedDate: '2011-06-01', facingMountain: 'S2' }),
});
const { data } = await res.json();
console.log(data.chartType.id, data.palaces.find((p) => p.palace === 'S').pair);

L’orientation se donne soit en degrés dans le sens horaire depuis le nord vrai (facing: 180), soit par le nom de l’une des 24 montagnes : par code (S2), en pinyin (Wu) ou en caractère (午). Même chose pour la période : par un nombre (period: 8) ou par la date d’emménagement (occupiedDate), et l’année est alors comptée à partir de l’instant exact de Lichun, et non d’un 4 février fixe.

Type de thème

Quatre configurations canoniques, et la réponse nomme celle qui est obtenue :

id	中文	Lecture
wang-shan-wang-shui	旺山旺水	La plus favorable : les personnes derrière, l’argent devant
shang-shan-xia-shui	上山下水	Inversée ; c’est là que le praticien s’intéresse au paysage extérieur
double-facing	雙星到向	Les deux étoiles devant : bon pour l’argent, il faut un appui derrière
double-sitting	雙星到坐	Les deux derrière : bon pour les personnes, il faut de l’eau devant

Ce que nous avons vérifié, et avec quoi

La règle du vol des étoiles est plus souvent mal formulée que bien. Ce qui envoie une étoile en avant ou en arrière, ce n’est pas la polarité de la montagne vers laquelle fait face le bâtiment, mais la polarité de la montagne à la même position ordinale dans le secteur du propre trigramme de l’étoile.

La lecture naïve reproduit 6 des 24 thèmes publiés de la période 8 et échoue sur 18. Une ou deux vérifications l’auraient laissée passer ; c’est pourquoi les tests contiennent l’ensemble publié complet : 24 thèmes, 9 palais, 3 étoiles, 648 nombres, et tous concordent.

L’étoile 5 n’a pas de trigramme propre et emprunte la polarité de l’étoile de la période. La deuxième version répandue (“la polarité du palais d’où vient le 5”) est la même version : le 5 se retrouve toujours dans le palais dont le nombre Lo Shu vaut 10 − période, et ce nombre a toujours la parité de la période. C’est démontré pour les neuf périodes, et non laissé comme réserve.

Note

替卦 (étoiles de remplacement) volontairement non implémentées. Certaines écoles les appliquent quand la mesure tombe près de la limite d’une montagne. Cela change le thème, et les écoles ne s’accordent pas sur les conditions. Au lieu d’un choix silencieux, la réponse prévient : si ta mesure est à moins de 1.5° d’une limite, warnings contiendra la distance et la montagne voisine.

Étoiles annuelles et afflictions

POST /v1/chinese/feng-shui/annual-stars donne les neuf étoiles annuelles et les quatre ou cinq afflictions de l’année. La différence entre elles compte pour qui s’apprête à agir :

• Tai Sui (太歲) et Sui Po (歲破) occupent chacun une montagne, 15° chacun.
• San Sha (三煞) occupe un secteur entier, 45°.
• Le Cinq Jaune (五黃) et le Deux Noir (二黑) sont des secteurs du thème annuel.

Pour 2026, la réponse place le Cinq Jaune au sud, Tai Sui en S2 (午), Sui Po en N2 et San Sha au nord, ce qui concorde avec les almanachs publiés ; ces quatre valeurs sont fixées par un test.

L’année est ici solaire et commence à Lichun. Une date de janvier appartient à l’année précédente, et c’est justement pourquoi rien n’est substitué par défaut : sans year ni date, ce sera 400.

À proximité

Le reste de la surface feng shui existait déjà dans l’API et ne bouge pas : POST /v1/chinese/feng-shui/kua (nombre Kua), /lucky-directions (huit directions personnelles) et /bagua (carte des neuf domaines de vie).