AstroWay/api v2.201.7 · hu
minden rendszer működik rendben
// astrology api · POST /v1/profections

Éves profekciók API

Az éves profekciók a hellenisztikus eszköztár legegyszerűbb időzítési technikája, és az egyik leggyakrabban használt: a horoszkóp minden életévvel egy házzal előrehalad, és az adott házban lévő jegy uralkodója lesz az év ura. Egy szám be, egy bolygó ki, és az egész évnek van egy aláírása.

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

Éves profekciók API

Az endpoint a születési adatokat és egy céldátumot kapja, megszámolja a születés pillanatától eltelt befejezett éveket, és minden évhez egy teljes jegyet léptet előre az aszcendensből. A válasz tartalmazza a számolt életkort, a nulla-alapú indexet annak a jegynek, amelyre az év esik, és a jegyet uraló bolygót mint lordOfYear, valamint a születési aszcendenset, MC-t, Napot és Holdat, így a chartot egy hívás nélkül is megjelenítheted. A ház száma közvetlenül az életkortól függ: a ciklus tizenkét év, ezért a profektált ház az életkor modulo tizenkettő, plusz egy. A 36. életkor visszatér az első házba, így az aszcendens saját jegyébe, ezért a mintahoroszkóp, ahol az aszcendens 169,97 fokban van Szűzben, signIndex 5-öt és Merkúrt ad vissza év ura-ként. Mivel a számolás a születés pillanatától indul, nem a naptártól, a profekciós év a születésnapon változik, nem január első napján.

// 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

Használd a profekciókat, ha olyan időzítési rétegre van szükséged, amit az olvasó ephemerisz nélkül is követhet. Minden évnek egy uralkodó bolygója van, így egy éves előrejelzés, születésnapi jelentés vagy AI-narratíva építhető egyetlen világos állításra a tranzit táblázat helyett. Különösen jól kombinálható tranzitokkal és visszatérésekkel: itt megtalálod az év urát, aztán megnézed, mi történik ezzel a bolygóval tranzitban, és megkapod a klasszikus kétlépéses olvasást két hívásban. Emellett párosítható a napévi visszatéréssel, ami ugyanazt az évet más szögből fedi le. A technika szándékosan durva: megmondja, melyik életterület aktiválódik és ki irányítja, nem pedig, mi történik egy adott délután, szóval tekintsd úgy, mint egy keretet, amire finomabb időzítést akasztasz.

// 05 / Notes

Notes

Teljes-jegy profekciók az aszcendensből, egy jegy befejezett évként, a hagyományos uralkodó urak adják az év urát. Az életkorok a születés pillanatától számolódnak, így az év a születésnapon változik. A születési aszcendens, MC, Nap és Hold a Swiss Ephemeris motorból származik a trópusi zodiákusban, és fokban visszaadott.

Try the Éves profekciók API

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

99,9% SLA · fizetős csomagok · 30 nap állapot →