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

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

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"
  }'

{
  "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 і назвою поля.