AstroWay/api v2.201.7 · cs
všechny systémy jsou v pořádku
// astrology api · POST /v1/profections

API Ročních profece

Roční profece jsou nejjednodušší časovou technikou v helénistickém nástroji a jednou z nejčastěji používaných: graf postupuje o jeden dům za rok života, a vládce znamení v tomto domě se stane pánem roku. Jeden číslo dovnitř, jedna planeta ven, a celý rok má svou podpisovou charakteristiku.

Endpoint
POST /v1/profections
Cost
20 credits
Latency
~48 ms
Tier
Tier 2
// 01 / What it computes

API Ročních profece

Koncový bod přijme data narození a cílové datum, spočítá uplynulé roky od okamžiku narození a posune o celé znamení od Ascendentu pro každý z nich. Odpověď hlásí věk, který spočítal, nulový index znamení, na které rok dopadá, a planetu vládnoucí tomuto znamení jako lordOfYear, spolu s natálním Ascendentem, MC, Sluncem a Měsícem, abyste mohli vykreslit rok proti grafu bez druhého volání. Číslo domu samotné přímo vyplývá z věku: cyklus trvá dvanáct let, takže profektovaný dům je věk modulo dvanáct, plus jedna. Věk 36 se vrací do prvního domu a tedy do vlastního znamení Ascendentu, proto vzorový graf s Ascendentem na 169.97 stupňů v Panně hlásí signIndex 5 a Merkur jako pána toho roku. Protože počítání běží od okamžiku narození nikoli od kalendáře, roční profece se mění v den narození a ne na první ledna.

// 02 / Live request

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"
}'
Response (excerpt)
{
  "ok": true,
  "data": {
    "age": 36,
    "signIndex": 5,
    "lordOfYear": "Mercury",
    "ascendant": 169.9680,
    "mc": 77.0743,
    "sun": 54.3760,
    "moon": 296.9047
  }
}
// 03 / Parameters

Parameters

nametypeRequired
date string (YYYY-MM-DD) yes Birth date.
time string (HH:MM:SS) yes Local clock time at birth.
timezoneOffset number (hours) yes UTC offset in effect at the birth moment.
latitude number yes Birth-place latitude, decimal degrees (north positive).
longitude number yes Birth-place longitude, decimal degrees (east positive).
targetDate string (YYYY-MM-DD) yes 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 / When to use it

When to use it

Používejte profece, když potřebujete časovou vrstvu, kterou čtenář může sledovat bez efemeridy. Každý rok má jednu vládnoucí planetu, takže roční předpověď, narozeninová zpráva nebo AI vyprávění může být postaveno kolem jediné jasné úvahy místo tabulky transits. Skladuje se zejména dobře s transity a návraty: najděte zde pána roku, pak se podívejte, co se s touto planetou děje transitně, a máte klasické dvoukrokové čtení ve dvou voláních. Spolupracuje také se slunečním návratem, který pokrývá stejný rok z jiného úhlu. Technika je záměrně hrubá. Říká vám, který životní obor je aktivován a kdo je za něj zodpovědný, ne co se děje konkrétního odpoledne, takže k němu přistupujte jako do rámu, na který pověsíte jemnější časování.

// 05 / Notes

Notes

Profece celých znamení z Ascendentu, jedno znamení za uplynulý rok, s tradičními vládci domů určujícími pána roku. Věky se počítají od okamžiku narození, takže rok se mění v den narození. Natální Ascendent, MC, Slunce a Měsíc pocházejí z motoru Swiss Ephemeris v tropickém zvěrokole a jsou vráceny ve stupních.

Try the Roční profece API

Grab a key and make your first call in under a minute.

99,9% SLA · placené plány · 30 dní status →