Rychlý start API astrologie: TypeScript a Python za 5 minut

🕓 Zápis z 2026-04-14, aktualizováno 2026-05-09. TS / Python / PHP SDK nyní žijí na veřejných registrech — @astroway/sdk (npm), astroway (PyPI), astroway/sdk (Packagist). Více v changelogu.

Chceš spočítat natalní mapu z kódu? Tady je ten nejrychlejší způsob — za 5 minut od nuly k funkčnímu JSON.

Krok 1: Získej API klíč (30 sekund)

Zaregistruj se na api.astroway.info/dashboard/sign-up. Bezplatný plán: 10 000 kreditů / měsíc. Bez karty.

V dashboardu klikni na „Create key“ → „Production“ → zkopíruj. Klíče vypadají takto: aw_live_aB3xY7pQ9rN2mK4jH8vC5tL6wZ1fD0eR.

Tip: Existují také sandboxové klíče s prefixem aw_test_ — ty neodečítají kredity. Používej je během vývoje.

Krok 2: Nainstaluj SDK

TypeScript

npm install @astroway/sdk

Python

pip install astroway

Obě SDK pokrývají všechny 723 endpointy s typizovanými požadavky a odpověďmi.

Krok 3: První natalní mapa

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, léto v Kyjevě
  latitude: 50.4501,
  longitude: 30.5234,
  houseSystem: 'P',       // Placidus
});

console.log(`Slunce: ${chart.planets[0].sign} na ${chart.planets[0].longitude}°`);
console.log(`ASC: ${chart.houses.ascendant}°`);
console.log(`Aspekty: ${chart.aspects.length}`);

Spusť:

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"Slunce: {chart['planets'][0]['sign']} na {chart['planets'][0]['longitude']}°")
print(f"ASC: {chart['houses']['ascendant']}°")
print(f"Aspekty: {len(chart['aspects'])}")

Spusť:

ASTROWAY_API_KEY=aw_live_... python3 chart.py

Co vrací API

Vrací se JSON objekt se čtyřmi hlavními částmi:

planets

Pole s 12 objekty (Slunce, Měsíc, Merkur, Venuše, Mars, Jupiter, Saturn, Uran, Neptun, Pluto, Severní uzel, Chiron):

{
  "name": "Slunce",
  "longitude": 111.87,      // ekliptická délka ve stupních
  "latitude": 0.0,
  "speed": 0.955,           // stupňů za den (záporné = retrográdní)
  "sign": "cancer",
  "signIndex": 3,
  "house": 10,
  "retrograde": false
}

houses

Kuspidy domů (12 kusů), stejně jako asc a MC:

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

aspects

Pole aspektů mezi planetami:

{
  "planet1": "Slunce",
  "planet2": "Měsíc",
  "type": "sextile",        // conjunction, opposition, trine, square, sextile, quincunx
  "orb": 1.36,              // odchylka od přesného v stupních
  "applying": true
}

chartSect

"diurnal" (Slunce nad horizontem v okamžiku narození) nebo "nocturnal" (pod horizontem). Používá se v klasické astrologii.

Co dál

Co ještě vyzkoušet:

Synastrie — kompatibilita dvou lidí:

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(`Skóre kompatibility: ${synastry.compatibility.score}/100`);

Současné transity na natalní mapu:

const transits = await client.transits({
  // data narození
  date: '1990-07-14', time: '14:30:00', timezoneOffset: 3,
  latitude: 50.4501, longitude: 30.5234,
  // datum transitu
  transitDate: '2026-04-14',
});

Denní horoskop s reálnými transity:

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);

Úplná Human Design mapa:

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} — Profil ${hd.profile}`);

Cena v kreditech

Natalní mapa (/chart): 20 kreditů
Synastrie: 50 kreditů
Transity: 50 kreditů
Denní horoskop: 20 kreditů
Human Design: 50 kreditů

Bezplatný plán: 10 000 kreditů / měsíc = 500 natalních map, nebo 200 synastrie, nebo smíšené zatížení.

Zpracování chyb

Každá odpověď obsahuje hlavičky s kredity:

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

Když dojdou kredity — dostaneš 402 Payment Required. Když překročíš rate-limit (Free: 10 požadavků / min) — 429 Too Many Requests s hlavičkou Retry-After.

SDK vyhazuje typizované chyby, které můžeš chytat:

try {
  const chart = await client.chart({ ... });
} catch (err) {
  if (err.code === 'credits_exhausted') {
    console.log('Přepni na placený plán nebo počkej na reset');
  } else if (err.code === 'rate_limit_exceeded') {
    console.log(`Zkus to znovu za ${err.retryAfter} sekund`);
  }
}

A to je vše

Teď už máš:

Funkční API klíč
Nainstalované SDK
První natalní mapu
Dostatek příkladů, abys přidal/a synastrie, transity, horoskopy

Čti dál:

Úplný průvodce „odkud začít“ — více detailů
Příklad: natalní mapa — hlubší walkthrough
API reference — všechny 723 endpointy

AstroWay team

Inženýrský tým AstroWay API. Zabalujeme Swiss Ephemeris do čistého RESTu a píšeme o nudných detailech, které jsou ve skutečnosti důležité.

// postav na tom

Stejný Swiss Ephemeris jako v Solar Fire — ve 4 řádcích kódu.

Zdarma klíč bez karty. 5 000 volání za měsíc do první platby.

Získat API klíč → Dokumentace

Rychlý start API astrologie: TypeScript a Python za 5 minut

Krok 1: Získej API klíč (30 sekund)

Krok 2: Nainstaluj SDK

TypeScript

Python

Krok 3: První natalní mapa

TypeScript

Python

Co vrací API

planets

houses

aspects

chartSect

Co dál

Cena v kreditech

Zpracování chyb

A to je vše

Stejný Swiss Ephemeris jako v Solar Fire — ve 4 řádcích kódu.

Více z blogu všechny příspěvky →

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)