Vliegende sterren (玄空飛星)

Xuan Kong Fei Xing (玄空飛星) is de feng-shuischool die een horoscoop niet voor een mens opstelt, maar voor een gebouw. Twee gegevens zijn genoeg, en beide zijn verplicht: de periode waarin het gebouw in gebruik werd genomen, en de richting waarin het kijkt. Daaruit volgen drie getallen voor elk van de negen sectoren.

Drie sterren in elk paleis

Ster	中文	Waarvoor ze wordt gelezen
Bergster	山星	Mensen, gezondheid, relaties
Periodester	運星	Het tijdperk waartoe het gebouw behoort
Frontster (facing star)	向星	Geld, kansen, beweging

Het getal van een ster en haar vlucht zijn exacte rekenkunde. Wat een paar getallen in een bepaalde kamer betekent, is al een interpretatietraditie, met meer dan één school. In het antwoord zijn die twee helften gescheiden, en in notes staat waar de berekening ophoudt.

Endpoints

Endpoint	Credits	Wat het teruggeeft
POST /v1/chinese/feng-shui/flying-star	10	Geboortehoroscoop van het gebouw: negen paleizen, type horoscoop, bijzondere patronen
POST /v1/chinese/feng-shui/annual-stars	10	Jaarsterren en afflicties van het jaar, optioneel met een maandlaag

Opgepast

De periode heeft geen standaardwaarde. Zonder period of occupiedDate geeft het verzoek een 400 terug. Een gebouw dat in 1998 in gebruik werd genomen, hoort bij periode 7, en een zelfverzekerde horoscoop voor periode 9 zou daarvoor gewoon een fout antwoord zijn met een correct uiterlijk.

Voorbeeld

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);

De richting kun je opgeven in graden met de klok mee vanaf het ware noorden (facing: 180), of met de naam van een van de 24 bergen: als code (S2), in pinyin (Wu) of als karakter (午). Voor de periode geldt hetzelfde: als getal (period: 8) of als datum van ingebruikname (occupiedDate), en dan wordt het jaar gerekend vanaf het exacte moment van Lichun, niet vanaf een vaste 4 februari.

Type horoscoop

Er zijn vier canonieke opstellingen, en het antwoord noemt degene die eruit komt:

id	中文	Duiding
wang-shan-wang-shui	旺山旺水	De gunstigste: mensen achter, geld voor
shang-shan-xia-shui	上山下水	Omgekeerd; juist hier vraagt een beoefenaar naar het landschap buiten
double-facing	雙星到向	Beide sterren voor: goed voor geld, steun aan de achterkant nodig
double-sitting	雙星到坐	Beide achter: goed voor mensen, water aan de voorkant nodig

Wat we hebben gecontroleerd, en waarmee

De regel voor de vlucht van een ster wordt vaker verkeerd dan goed geformuleerd. Of een ster vooruit of achteruit vliegt, wordt niet bepaald door de polariteit van de berg waarin het gebouw kijkt, maar door de polariteit van de berg op dezelfde rangpositie in de sector van het eigen trigram van de ster.

De naïeve lezing reproduceert 6 van de 24 gepubliceerde horoscopen voor periode 8 en faalt bij 18. Een of twee controles zouden dat hebben laten passeren, daarom zit de volledige gepubliceerde set in de tests: 24 horoscopen, 9 paleizen, 3 sterren, 648 getallen, en ze kloppen allemaal.

Ster 5 heeft geen eigen trigram en leent de polariteit van de periodester. De tweede gangbare versie (“de polariteit van het paleis waaruit de 5 kwam”) is dezelfde versie: de 5 belandt altijd in het paleis met het Lo Shu-getal 10 − період, en dat heeft altijd de pariteit van de periode. Dat is bewezen voor alle negen periodes, niet als voorbehoud blijven staan.

Opmerking

替卦 (vervangende sterren) zijn bewust niet geïmplementeerd. Sommige scholen passen ze toe wanneer een meting dicht bij de grens van een berg valt. Dat verandert de horoscoop, en de scholen zijn het oneens over de voorwaarden. In plaats van stilzwijgend te kiezen waarschuwt het antwoord: ligt je meting dichter dan 1.5° bij een grens, dan staan in warnings de afstand en de naburige berg.

Jaarsterren en afflicties

POST /v1/chinese/feng-shui/annual-stars geeft de negen jaarsterren en de vier à vijf afflicties van het jaar. Het verschil daartussen is belangrijk voor wie iets wil ondernemen:

• Tai Sui (太歲) en Sui Po (歲破) beslaan elk één berg, 15° per stuk.
• San Sha (三煞) is een hele sector, 45°.
• Vijf Geel (五黃) en Twee Zwart (二黑) zijn sectoren van de jaarhoroscoop.

Voor 2026 plaatst het antwoord Vijf Geel in het zuiden, Tai Sui op S2 (午), Sui Po op N2 en San Sha in het noorden, wat overeenkomt met de gepubliceerde almanakken; deze vier waarden zijn in een test vastgelegd.

Het jaar is hier een zonnejaar en begint bij Lichun. Een datum in januari hoort bij het vorige jaar, en juist daarom wordt er niets standaard ingevuld: zonder year of date krijg je een 400.

Wat er verder is

De rest van de feng-shuifunctionaliteit zat al in de API en blijft waar ze was: POST /v1/chinese/feng-shui/kua (Gua-getal), /lucky-directions (acht persoonlijke richtingen) en /bagua (kaart van de negen levensgebieden).