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

Parans API

Paran je bod, kde se kříží dvě astrologické linie: místo, kde byly dva planety zároveň v úhlových pozicích. Tento endpoint vrací každý křížek pro okamžik narození, včetně souřadnic každého, takže můžete označit body na mapě, kde se dvě planetární témata spojují, místo aby pouze probíhaly vedle sebe.

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

Parans API

Endpoint převádí okamžik narození na juliánský den, vypočítává kompletní sadu astrologických map (čtyři úhlové linie na těleso) a následně protíná každou linii s každou lininou patřící jiné planetě. Každý průsečík je vrácen s oběma mateřskými planetami, oběma typy linek a zeměpisnou šířkou a délkou, kde křížek leží. Protože MC a IC linie jsou poledníky a AC a DC linie jsou závislé na šířce, většina křížků je geometrická nikoli symetrická: pár Slunce-MC a Měsíc-ASC se setkává na přesně jednom místě na polokouli, ne na společném pásu. Typická mapa dává na celém světě něco přes čtyři sta křížků, a proto jsou vráceny jako plochý, řaditelný seznam, nikoli předem filtrované podle jakéhokoliv pojetí důležitosti.

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

Sáhněte po paranech, když jsou astrologické linie samy o sobě příliš hrubé. Linie říkají uživateli, že koridor nese Jupitera; parany mu říkají, že na jednom konkrétním místě v tom koridoru se Jupiter setkává s Venuší. Toto rozlišení je za co platí konzultanti přes přesuny, a je to vrstva, kterou většina mapových nástrojů vynechává. V praxi: vykreslete linie jako polyčáry a parany jako klikatelné značky, nebo filtrujte seznam na páry planet, které váš produkt zajímá, a řaďte blízká města podle blízkosti těchto bodů. Odpověď obsahuje pouze souřadnice, takže je můžete připojit k vaší vlastní databázi měst nebo regionů bez boje s textovým formátem. Všimněte si, že tento endpoint nevyžaduje místo narození, pouze okamžik, protože křížky jsou vlastnostmi nebe nikoli místem, kde se osoba náhodou nacházela.

// 05 / Notes

Notes

Pozice pocházejí ze Swiss Ephemeris (Astrodienst) zkompilovaného do WASM, stejný motor jako u natal endpointů, takže parany ukotvují na stejných planetárních délkách jako linie, od kterých odvozené. Křížky jsou vypočítány v tropickém zodiaku z kompletní geometrie linek nikoli z aproximace šířky. Klasická paranská doktrina stanovená Bernadette Brady také zachází s parany mezi hvězdami a planetami a hlásí je jako šířku nikoli bod; tento případ má svůj vlastní endpoint, [hvězda-planeta parany](/astrology-api/star-parans/). Tento pokrývá případ planeta-planeta, který samotná astrologická mapa generuje.

Try the Parans API

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

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