AstroWay/api v2.258.3 · pl
wszystkie systemy w normie
// astrology api · POST /v1/chinese/tong-shu/select

API do wyboru dat według almanachu Tong Shu

Przeskanuj okno dni i otrzymaj tylko te, które almanak zatwierdza dla konkretnego przedsięwzięcia, wraz z powodem, dla każdej pomyślnej daty, oraz zliczeniem odrzuconych i powodem odrzucenia.

Endpoint
POST /v1/chinese/tong-shu/select
Koszt
20 kredytów
Opóźnienie
~110 ms
Poziom
Tier 2
// 01 / Co oblicza

API do wyboru dat według almanachu Tong Shu

Każdy dzień w oknie jest przypisany do swojej kolumny dziennej z cyklu sekstynaryjnego, a następnie sprawdzany w dwóch niezależnych rejestrach. Dwunastu urzędników 建除十二值星 cykluje z gałęzią miesiąca, a każdy ma własną listę tego, co jest odpowiednie i czego zabrania: Pełne odpowiednie podpisywanie i świętowanie, Prawie nic nie jest odpowiednie. Dwadzieścia osiem pałaców księżycowych cyklują siedmiodniowym rytmem niezależnie od urzędników i mają własne rekomendacje. Dzień jest dopuszczony tylko wtedy, gdy wybrana aktywność przejdzie oba rejestry. Opcjonalny filtr konfliktu usuwa dni, których gałąź stoi w opozycji do nazwanego przez Ciebie zwierzęcia, co jest tradycyjnym sposobem wykluczenia osoby, dla której dzień jest wybierany. Odpowiedź zgłasza przeskanowane, dopasowane oraz szczegółowe odrzucenia według rejestru i konfliktu, dzięki czemu pusta odpowiedź jest zrozumiała, a nie tajemnicza.

// 02 / Zapytanie na żywo

POST/v1/chinese/tong-shu/select

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"
  }'
Odpowiedź (fragment)
{
  "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"
      }
    ]
  }
}
// 03 / Parametry

Parametry

nametypeWymagane
from string (YYYY-MM-DD) tak First day of the window to scan.
to string (YYYY-MM-DD) tak Last day of the window.
activity string tak What the day is for: marriage, opening, moving, travel, medical, education, funeral and the rest of the register's own list.
avoidClashWith string nie 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 nie Any of 21 codes for the animal names.
// 04 / Kiedy używać

Kiedy używać

Sięgnij po to w procesach rezerwacji, planowaniu wydarzeń, produktach ślubnych i lokacyjnych, harmonogramie klinicznym lub wszędzie tam, gdzie selektor dat powinien cicho preferować niektóre dni nad innymi. Ponieważ zwraca uzasadnienie, a nie tylko werdykt, możesz pokazać użytkownikowi, dlaczego trzecia wtorkowa jest brakująca, zamiast cicho ją wygaszać. Przekazaj wynik bezpośrednio do komponentu kalendarza lub użyj liczb, aby zdecydować, czy okno potrzebuje poszerzenia, zanim zapytasz ponownie.

// 05 / Uwagi

Uwagi

Oba rejestry pochodzą z tradycji drukowanego almanaku, a nie z wymyślonego rankingu, a endpoint nigdy nie wymyśla dnia: pusty wynik pozostaje pusty i zgłasza, który rejestr go opróżni. Granica dnia to 23:00, zgodnie z każdym innym chińskim endpointem tutaj. Nazwy aktywności podążają za własną listą rejestru, więc nieznana aktywność jest odrzucana z błędem 400, który nazwie pole.

Wypróbuj API Wybór dat według almanachu Tong Shu

Zdobądź klucz i wykonaj pierwsze wywołanie w niecałą minutę.

99.9% SLA · plany płatne · 30d status →