AstroWay/api v2.200.11 · pl
wszystkie systemy w normie
// astrology api · POST /v1/profections

API Roczn Profeckcji

Roczne profeckcje to najprostsza technika czasowa w hellenistycznym zestawie narzędzi i jedna z najczęściej stosowanych: wykres przesuwa się o jedną dom rocznie życia, a władca znaku w tym domu staje się panem roku. Jedna liczba wchodzi, jedna planeta wychodzi, a cały rok ma sygnaturę.

Endpoint
POST /v1/profections
Koszt
20 kredytów
Opóźnienie
~48 ms
Poziom
Tier 2
// 01 / Co oblicza

API Roczn Profeckcji

Punkt końcowy przyjmuje dane urodzeniowe i docelową datę, liczy ukończone lata od momentu urodzenia i przesuwa o cały znak od Ascendentu dla każdego z nich. Odpowiedź zgłasza wiek, który policzył, indeks oparty na zerze znaku, na którym ląduje rok, oraz planetę rządzącą tym znakiem jako lordOfYear, wraz z natalnym Ascendentem, MC, Słońcem i Księżycem, aby można było wyrenderować rok na wykresie bez drugiego wywołania. Numer domu wynika bezpośrednio z wieku: cykl trwa dwanaście lat, więc dom profecki to wiek modulo dwanaście, plus jeden. Wiek 36 powraca do pierwszego domu, a więc do własnego znaku Ascendentu, dlatego przykładowy wykres z Ascendentem w 169.97 stopniach w Pannie zgłasza signIndex 5 i Merkurego jako pana tego roku. Ponieważ liczenie biegnie od momentu urodzenia, a nie od kalendarza, rok profecki zaczyna się w urodziny, a nie 1 stycznia.

// 02 / Zapytanie na żywo

POST/v1/profections

curl -X POST https://api.astroway.info/v1/profections \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{
  "date": "1990-05-15",
  "time": "14:30:00",
  "timezoneOffset": 3,
  "latitude": 50.45,
  "longitude": 30.52,
  "targetDate": "2026-05-15"
}'
Odpowiedź (fragment)
{
  "ok": true,
  "data": {
    "age": 36,
    "signIndex": 5,
    "lordOfYear": "Mercury",
    "ascendant": 169.9680,
    "mc": 77.0743,
    "sun": 54.3760,
    "moon": 296.9047
  }
}
// 03 / Parametry

Parametry

nametypeWymagane
date string (YYYY-MM-DD) tak Birth date.
time string (HH:MM:SS) tak Local clock time at birth.
timezoneOffset number (hours) tak UTC offset in effect at the birth moment.
latitude number tak Birth-place latitude, decimal degrees (north positive).
longitude number tak Birth-place longitude, decimal degrees (east positive).
targetDate string (YYYY-MM-DD) tak The date whose profection year you want. Age is counted from the birth moment, so the year turns on the birthday, not on January 1.
// 04 / Kiedy używać

Kiedy używać

Używaj profeckcji, gdy potrzebujesz warstwy czasowej, którą czytelnik może śledzić bez efemerydy. Każdy rok ma jedną panującą planetę, więc roczny预报, raport urodzinowy lub narracja AI może być zbudowana wokół jednej jasnej tezy, zamiast tabeli tranzytów. Dobrze komponuje się zwłaszcza z tranzytami i powrotami: znajdź tutaj pana roku, a następnie spójrz, co dzieje się z tą planetą w tranzycie, i masz klasyczne dwuetapowe odczytanie w dwóch wywołaniach. Para się również z powrotem słonecznym, który obejmuje ten sam rok z innej perspektywy. Technika jest celowo gruboziarnista. Mówi ci, który dział życia jest aktywowany i kto nim zarządza, a nie co dzieje się o danej popołudniowej porze, więc traktuj ją jako ramę, na którą zawieszasz bardziej precyzyjne określenie czasu.

// 05 / Uwagi

Uwagi

Profeckcje całych znaków od Ascendentu, jeden znak na ukończony rok, z tradycyjnymi władcami domów dającymi pana roku. Wiek jest liczony od momentu urodzenia, więc rok zaczyna się w urodziny. Natalny Ascendent, MC, Słońce i Księżyc pochodzą z silnika Swiss Ephemeris w zodiaku tropikalnym i są zwracane w stopniach.

Wypróbuj API Roczne Profeckcje

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

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