# API вибору дати за Тун Шу

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

## Ендпоінт

`POST /v1/chinese/tong-shu/select`

- Operation ID: `chinese/tong-shu/select`
- Вартість: 20 кредитів (тариф 2)
- Типова латентність: 110 мс, заміряно на проді
- Канонічна сторінка: https://api.astroway.info/astrology-api/tong-shu-date-selection/

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

Кожен день у вікні зводиться до свого денного стовпа за шістдесятковим циклом, а далі читається через два незалежні реєстри. Дванадцять керівників дня 建除十二值星 обертаються разом із гілкою місяця, і кожен несе власний список того, що йому личить і що заборонено: 滿 личить підписанню і святу, 閉 не личить майже нічому. Двадцять вісім місячних стоянок обертаються за семиденним ритмом, незалежним від керівників, і несуть власні схвалення. День проходить лише тоді, коли обрана діяльність вижила в обох реєстрах. Необов'язковий фільтр зіткнення далі прибирає дні, чия гілка стоїть навпроти названої тварини: так традиція виключає саму людину, для якої день обирається. Відповідь повідомляє, скільки просканували, скільки збіглося і що відпало за реєстром і за зіткненням, тож порожня відповідь читається, а не залишається загадкою.

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

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

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

| Parameter | Type | Required | Description |
|---|---|---|---|
| `from` | string (YYYY-MM-DD) | yes | First day of the window to scan. |
| `to` | string (YYYY-MM-DD) | yes | Last day of the window. |
| `activity` | string | yes | What the day is for: marriage, opening, moving, travel, medical, education, funeral and the rest of the register's own list. |
| `avoidClashWith` | string | no | An animal name. Days whose branch clashes that animal are dropped, which is how the tradition excludes the person the day is for. |
| `language` | string | no | Any of 21 codes for the animal names. |

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

```bash
curl -X POST https://api.astroway.info/v1/chinese/tong-shu/select \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "from": "2026-06-01",
    "to": "2026-06-14",
    "activity": "marriage",
    "avoidClashWith": "Horse"
  }'
```

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

```json
{
  "ok": true,
  "data": {
    "activity": "marriage",
    "from": "2026-06-01",
    "to": "2026-06-14",
    "scanned": 14,
    "matched": 5,
    "dropped": { "byRegister": 9, "byClash": 0 },
    "days": [
      {
        "date": "2026-06-02",
        "verdict": "suitable",
        "dayPillar": "Ding-Wei",
        "officer": { "chinese": "滿", "name": "Full", "summary": "Fullness and return. Signing, opening, celebrating." },
        "mansion": { "chinese": "尾", "name": "Tail", "quadrant": "Azure Dragon" },
        "clashesWith": "Ox"
      }
    ]
  }
}
```

## Нотатки

Обидва реєстри походять з друкованої альманахової традиції, а не з вигаданого рейтингу, і ендпоінт ніколи не вигадує день: порожній результат лишається порожнім і називає реєстр, який його спорожнив. Межа доби 23:00, як і в усіх інших китайських ендпоінтах. Назви діяльностей ідуть за власним списком реєстру, тож невідома діяльність відхиляється з 400 і назвою поля.

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

- https://api.astroway.info/astrology-api/feng-shui-flying-star/
- 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