# API летючих зірок (Сюань Кун)

Напрям фасаду і період будівництва дають повну карту дев'яти палаців: зірка періоду, гірська зірка і зірка фасаду в кожному з дев'яти секторів, зі стихією, природою і значенням кожної.

## Ендпоінт

`POST /v1/chinese/feng-shui/flying-star`

- Operation ID: `chinese/feng-shui/flying-star`
- Вартість: 10 кредитів (тариф 1)
- Типова латентність: 70 мс, заміряно на проді
- Канонічна сторінка: https://api.astroway.info/astrology-api/feng-shui-flying-star/

## Що обчислює

Азимут зводиться до однієї з 24 гір, і це та роздільність, на якій система справді працює: по 15 градусів, три на сектор, і полярність гори задає напрям польоту зірок. З номера періоду ендпоінт ставить зірку періоду в центр і проводить решту вісім по палацах у порядку Ло Шу. Гори сидіння і фасаду дають гірську зірку і зірку фасаду, кожна летить вперед або назад за полярністю гори, з якої стартує, і саме тут більшість реалізацій помиляється непомітно. Кожен палац повертається з усіма трьома зірками, їхніми стихіями, ознакою своєчасності в періоді і парним читанням, з яким практики працюють насправді.

## Коли використовувати

Беріть під консультаційний інструмент, функцію в лістингу нерухомості, робочий процес дизайну інтер'єру або застосунок, що розмічає план приміщення. Відповідь це чиста структура, тож її можна намалювати сіткою три на три, накласти на план або віддати шару інтерпретації. Поєднуйте з ендпоінтом річних зірок, коли треба покласти поточний рік на натальну карту будівлі, і з числом Гуа, коли читання має враховувати мешканця, а не саму лише будівлю.

## Параметри запиту

| Parameter | Type | Required | Description |
|---|---|---|---|
| `facing` | number (degrees) | yes | Compass bearing the building faces, clockwise from true north. Or send facingMountain as one of the 24 mountains. |
| `period` | number (1-9) | yes | Construction period. Not defaulted to the current one: a building occupied in 1998 belongs to period 7, and answering with 9 would be a confident chart for the wrong building. |
| `occupiedDate` | string (YYYY-MM-DD) | no | Alternative to period. The period is derived from the date of occupation. |
| `language` | string | no | Any of 21 codes for the element names. |

## Приклад запиту

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

## Приклад відповіді

```json
{
  "ok": true,
  "data": {
    "period": { "number": 8, "source": "given" },
    "facing": { "degrees": 180, "mountain": "S2", "chinese": "午", "sector": "S", "polarity": "yin" },
    "sitting": { "mountain": "N2", "chinese": "子", "sector": "N", "degrees": 0 },
    "palaces": [
      {
        "palace": "N",
        "degrees": "337.5-22.5",
        "mountainStar": { "star": 9, "name": "Purple Fire", "element": "Fire", "nature": "auspicious" },
        "periodStar": { "star": 4, "name": "Green Wood", "element": "Wood", "nature": "mixed" },
        "facingStar": { "star": 7, "name": "Red Metal", "element": "Metal", "nature": "inauspicious" },
        "pair": "9-7"
      }
    ]
  }
}
```

## Нотатки

Період обов'язковий, а не підставлений за замовчуванням, і це навмисно: мовчазне припущення поточного періоду дає впевнену карту будівлі, якої не існує. Напрям польоту йде за полярністю стартової гори, таблиці пришпилені до опублікованих альманахових карт. Назви зірок несуть ієрогліфи поруч з англійським перекладом.

## Пов’язані техніки

- https://api.astroway.info/astrology-api/tong-shu-date-selection/
- https://api.astroway.info/astrology-api/bazi-chart/
- https://api.astroway.info/astrology-api/chinese-zodiac-compatibility/

---

Повна машиночитана специфікація: https://api.astroway.info/v1/openapi.json
Інструкції для агента: https://api.astroway.info/AGENTS.md