AstroWay/api v2.173.1 · ro
toate sistemele sunt în stare normală
// astrology api · POST /v1/parans

Parans API

Un paran este punctul unde două linii de astrocartografie se intersectează: un loc unde două planete erau simultan angulare. Acest endpoint returnează fiecare intersecție pentru un moment de naștere, cu coordonatele fiecăruia, astfel încât poți marca punctele de pe hartă unde două teme planetare fuzionează în loc să ruleze doar paralel.

Endpoint
POST /v1/parans
Cost
50 credits
Latency
~297 ms
Tier
Tier 3
// 01 / What it computes

Parans API

Endpoint-ul rezolvă momentul nașterii la o zi iuliană, calculează setul complet de astrocartografie (patru linii angulare pentru fiecare corp) și apoi intersectează fiecare linie cu fiecare linie aparținând unei planete diferite. Fiecare intersecție este returnată cu ambele planete părinte, ambele tipuri de linii, și latitudinea și longitudinea unde are loc intersecția. Deoarece liniile MC și IC sunt meridiane, iar liniile AC și DC sunt curbe dependente de latitudine, majoritatea intersecțiilor sunt geometrice mai degrabă decât simetrice: o pereche Soare-MC și Lună-ASC se întâlnesc într-un singur loc pe emisferă, nu pe o bandă comună. Un horoscop tipic produce peste patru sute de intersecții pe glob, motiv pentru care sunt returnate ca o listă plată, sortabilă, nu pre-filtrate după nicio noțiune de importanță.

// 02 / Live request

POST/v1/parans

curl -X POST https://api.astroway.info/v1/parans \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{
  "date": "1990-05-15",
  "time": "14:30:00",
  "timezoneOffset": 3
}'
Response (excerpt)
{
  "ok": true,
  "data": {
    "count": 414,
    "parans": [
      {
        "planet1Id": 0,
        "planet1Name": "Sun",
        "line1Type": "MC",
        "planet2Id": 1,
        "planet2Name": "Moon",
        "line2Type": "ASC",
        "location": { "lat": -45.9153, "lng": 6.5735 }
      }
    ]
  }
}
// 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) no UTC offset in effect at the birth moment. Defaults to 0. Decimal allowed for half-hour zones.
// 04 / When to use it

When to use it

Recurge la parans când liniile de astrocartografie singure sunt prea grosolane. Liniile spun unui utilizator că un coridor poartă Jupiter; parans îi spun că într-un anumit loc specific din acel coridor Jupiter întâlnește Venus. Această distincție este pentru ce consultanții de relocare percep taxe, și este stratul pe care majoritatea instrumentelor de hartă îl sar. Practic: randează liniile ca polilinii și parans ca marcatori clickabili, sau filtrează lista la perechile de planete pe care produsul tău le consideră importante și clasifică orașele apropiate după proximitate față de acele puncte. Răspunsul conține doar coordonate, așadar îl poți uni cu propriul set de date de oraș sau regiune fără a lupta cu un format prozaic. Reține că acest endpoint nu necesită locul de naștere, doar momentul, deoarece intersecțiile sunt proprietăți ale cerului, nu ale locului unde persoana s-a născut.

// 05 / Notes

Notes

Pozițiile provin din Swiss Ephemeris (Astrodienst) compilat în WASM, același motor ca și endpoint-urile natale, așadar parans se ancorează la aceleași longitudini planetare ca și liniile din care derivă. Intersecțiile sunt calculate în zodiacul tropical din geometria completă a liniei, nu dintr-o aproximație de latitudine. Doctrina clasică a parans, așa cum este stabilită de Bernadette Brady, tratează și parans de tip stea-la-planeta, și le raportează ca o latitudine mai degrabă decât un punct; acel caz are propriul său endpoint, [parans stea-planeta](/astrology-api/star-parans/). Acesta acoperă cazul de planetă-la-planetă pe care îl generează însăși harta de astrocartografie.

Try the Parans API

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

99,9% SLA · planuri plătite · 30 zile status →