Asztrológiai API gyors kezdés: TypeScript és Python 5 perc alatt

🕓 Bejegyzés 2026-04-14, frissítve 2026-05-09. A TS / Python / PHP SDK-k most a nyilvános regisztráción vannak — @astroway/sdk (npm), astroway (PyPI), astroway/sdk (Packagist). Részletek a changelog-ban.

Szeretnél születési térképet számolni a kódból? Itt a legrövidebb út — 5 perc alatt működő JSON-t kapsz.

1. lépés: Kapj API-kulcsot (30 másodperc)

Regisztrálj az api.astroway.info/dashboard/sign-up oldalon. Ingyenes terv: 10 000 kredit/hónap. Kártya nélkül.

A vezérlőpulton kattints a „Create key” → „Production” gombra, majd másold ki. A kulcsok aw_live_aB3xY7pQ9rN2mK4jH8vC5tL6wZ1fD0eR formátumúak.

Tipp: Van tesztkulcs is aw_test_ prefixszel — ezek nem vonnak le krediteket. Fejlesztés alatt használd őket.

2. lépés: Telepítsd az SDK-t

TypeScript

npm install @astroway/sdk

Python

pip install astroway

Mindkét SDK lefedi az összes 723 endpointot, típusos lekérdezésekkel és válaszokkal.

3. lépés: Első születési térkép

TypeScript

import { Astroway } from '@astroway/sdk';

const client = new Astroway({
  apiKey: process.env.ASTROWAY_API_KEY!,
});

const chart = await client.chart({
  date: '1990-07-14',
  time: '14:30:00',
  timezoneOffset: 3,      // UTC+3, nyári időszámítás Kijevben
  latitude: 50.4501,
  longitude: 30.5234,
  houseSystem: 'P',       // Placidus
});

console.log(`Nap: ${chart.planets[0].sign} a(z) ${chart.planets[0].longitude}°-n`);
console.log(`ASC: ${chart.houses.ascendant}°`);
console.log(`Aspektusok: ${chart.aspects.length}`);

Futtatás:

ASTROWAY_API_KEY=aw_live_... npx tsx chart.ts

Python

from astroway import Astroway

client = Astroway(api_key="aw_live_your_key_here")

chart = client.chart(
    date="1990-07-14",
    time="14:30:00",
    timezone_offset=3,
    latitude=50.4501,
    longitude=30.5234,
    house_system="P",
)

print(f"Nap: {chart['planets'][0]['sign']} a(z) {chart['planets'][0]['longitude']}°-n")
print(f"ASC: {chart['houses']['ascendant']}°")
print(f"Aspektusok: {len(chart['aspects'])}")

Futtatás:

ASTROWAY_API_KEY=aw_live_... python3 chart.py

Mit ad vissza az API?

Visszaérkezik egy JSON-tartalom négy fő résszel:

planets

12 objektumot tartalmazó tömb (Nap, Hold, Merkúr, Vénusz, Mars, Jupiter, Szaturnusz, Uránusz, Neptunusz, Pluto, Északi Csomó, Kiron):

{
  "name": "Nap",
  "longitude": 111.87,      // ekliptikai hosszúság fokokban
  "latitude": 0.0,
  "speed": 0.955,           // fok/nap (negatív = retrográd)
  "sign": "cancer",
  "signIndex": 3,
  "house": 10,
  "retrograde": false
}

houses

12 ház kuszpidja, valamint az ASC és MC:

{
  "system": "P",
  "cusps": [12.34, 43.21, ...],   // 12 érték
  "ascendant": 12.34,
  "mc": 280.12
}

aspects

Bolygók közötti aspektusok tömbje:

{
  "planet1": "Nap",
  "planet2": "Hold",
  "type": "sextile",        // conjunction, opposition, trine, square, sextile, quincunx
  "orb": 1.36,              // eltérés a pontos értéktől fokokban
  "applying": true
}

chartSect

"diurnal" (a Nap a horizont felett a születéskor) vagy "nocturnal" (a horizont alatt). A klasszikus asztrológiában használják.

Mi legyen a következő?

Mit érdemes kipróbálni:

Szinasztría — két ember összeillősége:

const synastry = await client.synastry({
  chart1: { date: '1990-07-14', time: '14:30:00', timezoneOffset: 3, latitude: 50.45, longitude: 30.52 },
  chart2: { date: '1992-03-22', time: '09:15:00', timezoneOffset: 2, latitude: 48.85, longitude: 2.35 },
});
console.log(`Összeillőségi pontszám: ${synastry.compatibility.score}/100`);

Aktuális tranzitok a születési térképre:

const transits = await client.transits({
  // születési adatok
  date: '1990-07-14', time: '14:30:00', timezoneOffset: 3,
  latitude: 50.4501, longitude: 30.5234,
  // tranzit dátuma
  transitDate: '2026-04-14',
});

Napi horoszkóp aktuális tranzitokkal:

const horoscope = await client.horoscopeDaily({
  date: '1990-07-14', time: '14:30:00', timezoneOffset: 3,
  latitude: 50.4501, longitude: 30.5234,
});
console.log(horoscope.text);

Teljes Human Design-térkép:

const hd = await client.humanDesign({
  date: '1990-07-14', time: '14:30:00', timezoneOffset: 3,
  latitude: 50.4501, longitude: 30.5234,
});
console.log(`${hd.type} — ${hd.strategy} — ${hd.profile} profil`);

Kreditköltség

Születési térkép (/chart): 20 kredit
Szinasztría: 50 kredit
Tranzitok: 50 kredit
Napi horoszkóp: 20 kredit
Human Design: 50 kredit

Ingyenes terv: 10 000 kredit/hónap = 500 születési térkép, vagy 200 szinasztría, vagy vegyes terhelés.

Hiba kezelés

Minden válasz tartalmazza a kreditekkel kapcsolatos fejléceket:

X-Credits-Used: 20
X-Credits-Remaining: 4980
X-Credits-Reset: 2026-05-01T00:00:00Z

Ha elfogynak a kreditek — 402 Payment Required hibát kapsz. Ha túlléped a rate-limitet (Ingyenes: 10 kérés/perc) — 429 Too Many Requests hibát, a Retry-After fejléccel.

Az SDK típusos hibákat dob, amelyeket elkaphatsz:

try {
  const chart = await client.chart({ ... });
} catch (err) {
  if (err.code === 'credits_exhausted') {
    console.log('Frissítsd a terved, vagy várj a resetig');
  } else if (err.code === 'rate_limit_exceeded') {
    console.log(`Próbáld újra ${err.retryAfter} másodperc múlva`);
  }
}

És kész is vagy!

Most már van:

Működő API-kulcsod
Telepített SDK
Első születési térképed
Elég példa, hogy hozzáadd a szinasztríát, tranzitokat, horoszkópokat

Tovább olvasni:

Teljes útmutató „Honnan kezdjem?” — több részlet
Példa: születési térkép — mélyebb walkthrough
API referencia — összes 723 endpoint

AstroWay team

Az AstroWay API mérnöki csapata. A Swiss Ephemerist tisztán tartjuk REST formában, és írunk a fontos, unalmas részletekről.

// építs erre

Ugyanaz a Swiss Ephemeris, mint a Solar Fire-ben — 4 sor kóddal.

Ingyenes kulcs bankkártya nélkül. Havi 5 000 hívás a fizetésig.

API kulcs beszerzése → Dokumentáció

Asztrológiai API gyors kezdés: TypeScript és Python 5 perc alatt

1. lépés: Kapj API-kulcsot (30 másodperc)

2. lépés: Telepítsd az SDK-t

TypeScript

Python

3. lépés: Első születési térkép

TypeScript

Python

Mit ad vissza az API?

planets

houses

aspects

chartSect

Mi legyen a következő?

Kreditköltség

Hiba kezelés

És kész is vagy!

Ugyanaz a Swiss Ephemeris, mint a Solar Fire-ben — 4 sor kóddal.

További bejegyzések összes bejegyzés →

Natal Chart API in TypeScript: SDK + React Example

How Accurate Is the Swiss Ephemeris? Verified Benchmarks

Swiss Ephemeris: REST API vs pyswisseph (When to Use Which)