Γρήγορη εκκίνηση API αστρολογίας: TypeScript και Python σε 5 λεπτά

🕓 Αρχείο από 2026-04-14, ενημερώθηκε 2026-05-09. TS / Python / PHP SDK τώρα ζουν σε δημόσια καταχωρίσματα - @astroway/sdk (npm), astroway (PyPI), astroway/sdk (Packagist). Λεπτομέρειες στο changelog.

Θέλεις να υπολογίσεις το γενέθλιο χάρτη από κώδικα. Εδώ είναι η πιο σύντομη διαδρομή – σε 5 λεπτά από το μηδέν μέχρι ένα λειτουργικό JSON.

Βήμα 1: Πάρε το API‑key (30 δευτερόλεπτα)

Κάνε εγγραφή στο api.astroway.info/dashboard/sign-up. Δωρεάν πρόγραμμα: 10 000 credits / μήνα. Χωρίς κάρτα.

Στο dashboard πάτησε «Create key» → «Production» → αντιγράψτε. Τα κλειδιά έχουν τη μορφή aw_live_aB3xY7pQ9rN2mK4jH8vC5tL6wZ1fD0eR.

Συμβουλή: υπάρχουν επίσης sandbox‑κλειδιά με πρόθεμα aw_test_ – δεν αφαιρούν credits. Χρησιμοποίησέ τα κατά την ανάπτυξη.

Βήμα 2: Εγκατέστησε το SDK

TypeScript

npm install @astroway/sdk

Python

pip install astroway

Και τα δύο SDK καλύπτουν όλα τα 758 endpoint με τυποποιημένα αιτήματα και απαντήσεις.

Βήμα 3: Πρώτος γενέθλιος χάρτης

TypeScript

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

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

const chart = await aw.chart.compute({
  date: '1990-07-14',
  time: '14:30:00',
  timezoneOffset: 3,      // UTC+3, літо в Києві
  latitude: 50.4501,
  longitude: 30.5234,
  houseSystem: 'P',       // Placidus
});

const SIGNS = ['Aries', 'Taurus', 'Gemini', 'Cancer', 'Leo', 'Virgo',
               'Libra', 'Scorpio', 'Sagittarius', 'Capricorn', 'Aquarius', 'Pisces'];

const sun = chart.planets.find((p) => p.name === 'Sun')!;
console.log(`Sun: ${SIGNS[Math.floor(sun.longitude / 30)]} at ${sun.longitude.toFixed(2)}°`);
console.log(`ASC: ${chart.houses.ascendant.toFixed(2)}°`);
console.log(`Aspects: ${chart.aspects.length}`);

Τρέξε:

ASTROWAY_API_KEY=aw_live_... npx tsx chart.ts

Το αρχείο χρησιμοποιεί top‑level await, οπότε στο package.json πρέπει να υπάρχει "type": "module". Διαφορετικά το tsx θα πέσει με το Top-level await is currently not supported with the "cjs" output format.

Python

from astroway import Astroway, BirthData

aw = Astroway(api_key="aw_live_your_key_here")

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

SIGNS = ["Aries", "Taurus", "Gemini", "Cancer", "Leo", "Virgo",
         "Libra", "Scorpio", "Sagittarius", "Capricorn", "Aquarius", "Pisces"]

sun = next(p for p in chart["planets"] if p["name"] == "Sun")
print(f"Sun: {SIGNS[int(sun['longitude'] // 30)]} at {sun['longitude']:.2f}°")
print(f"ASC: {chart['houses']['ascendant']:.2f}°")
print(f"Aspects: {len(chart['aspects'])}")

Τρέξε:

ASTROWAY_API_KEY=aw_live_... python3 chart.py

Τι επιστρέφει το API

Επιστρέφει ένα JSON‑object με τέσσερα κύρια τμήματα:

πλανήτες

Πίνακας με 13 αντικείμενα. Στο name υπάρχει το όνομα του σώματος από το Swiss Ephemeris: Sun, Moon, Mercury, Venus, Mars, Jupiter, Saturn, Uranus, Neptune, Pluto, true Node (Βόρειος κόμβος), mean Apogee (Λίλιθ), Chiron.

{
  "id": 0,
  "name": "Sun",
  "longitude": 354.702,     // еклiптична довгота у градусах
  "latitude": -0.00016,
  "distance": 0.9945,       // в астрономічних одиницях
  "speedLong": 0.9971,      // градусів на день (від'ємне = ретроград)
  "speedLat": 0.00003,
  "speedDist": 0.00019,
  "isRetrograde": false,
  "declination": -1.4159,
  "rightAscension": 355.437
}

Το ζώδιο και το σπίτι δεν επιστρέχονται εδώ: υπολόγισε το ζώδιο ως Math.floor(longitude / 30), και το σπίτι από τις κλίσεις με houses.

σπίτια

Κλίσεις των σπιτιών (12 τεμάχια), καθώς και asc και MC:

{
  "system": "P",
  "cusps": [118.18, 138.27, ...], // 12 значень
  "ascendant": 118.18,
  "mc": 12.708,
  "armc": 11.69,
  "vertex": 253.97,
  "equatorialAsc": 100.75,
  "coAscWK": 81.13,
  "coAscMunkasey": 123.7,
  "polarAsc": 261.13
}

aspects

Πίνακας των ασπεκτών μεταξύ των πλανητών:

{
  "planet1": "Sun",
  "planet2": "Mercury",
  "planet1Id": 0,
  "planet2Id": 2,
  "type": {                 // об'єкт, не рядок
    "name": "Conjunction",
    "i18nKey": "aspect_conjunction",
    "angle": 0,
    "orb": 12,
    "symbol": "☌",
    "isMajor": true,
    "color": "#660480"
  },
  "exactAngle": 3.365,
  "orb": 3.365,             // відхилення від точного у градусах
  "isApplying": true
}

chartSect

"diurnal" (Ο Ήλιος πάνω από τον ορίζοντα τη στιγμή της γέννησης) ή "nocturnal" (κάτω από τον ορίζοντα). Χρησιμοποιείται στην κλασική αστρολογία.

Τι έπεται

Τι άλλο μπορείς να δοκιμάσεις:

Συναστρία: συμβατότητα δύο ατόμων:

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

Τρέχουσες μεταβάσεις στον γενέθλιο χάρτη:

const transits = await client.transits({
  // дані народження
  date: '1990-07-14', time: '14:30:00', timezoneOffset: 3,
  latitude: 50.4501, longitude: 30.5234,
  // дата транзиту
  transitDate: '2026-04-14',
});

Καθημερινό ωροσκόπιο από πραγματικές μεταβάσεις:

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

Πλήρης Human Design χάρτης:

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

Κόστος σε credits

Γενέθλιος χάρτης (/chart): 20 credits
Συναστρία: 50 credits
Μεταβάσεις: 50 credits
Καθημερινό ωροσκόπιο: 20 credits
Human Design: 50 credits

Δωρεάν πρόγραμμα: 10 000 credits / μήνα = 500 γενέθλιους χάρτες, ή 200 συναστρίες, ή μεικτό φορτίο.

Διαχείριση σφαλμάτων

Κάθε απάντηση περιέχει headers με credits:

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

Όταν εξαντληθούν τα credits – θα λάβεις 402 Payment Required. Όταν χτυπήσεις το rate‑limit (Free: 10 requests / min) – 429 Too Many Requests με header Retry-After.

Το SDK ρίχνει τυποποιημένα σφάλματα που μπορείς να πιάσεις:

import { QuotaExceededError, RateLimitError } from '@astroway/sdk';

try {
  const chart = await aw.chart.compute(birth);
} catch (err) {
  if (err instanceof QuotaExceededError) {
    console.log('Upgrade plan or wait for reset');
  } else if (err instanceof RateLimitError) {
    console.log(`Retry in ${err.retryAfterSeconds ?? 60} seconds`);
  } else {
    throw err;
  }
}

Πιάσε τα από το πιο συγκεκριμένο στο πιο γενικό: όλα κληρονομούν το ApiError, έτσι ο έλεγχος για αυτό πρώτο θα καταπιάσει τα υπόλοιπα.

Και αυτό είναι όλο

Τώρα έχεις:

Ένα λειτουργικό API‑key
Το SDK εγκατεστημένο
Τον πρώτο γενέθλιο χάρτη
Αρκετά παραδείγματα για να προσθέσεις συναστρία, μεταβάσεις, ωροσκόπια

Διάβασε παρακάτω:

Πλήρης οδηγός «πώς να ξεκινήσεις»: περισσότερες λεπτομέρειες
Παράδειγμα: γενέθλιος χάρτης: πιο βαθύ walkthrough
API reference: όλα τα 758 endpoint

MakSeong · AstroWay

Δημιουργώ το AstroWay API: τυλίγω το Swiss Ephemeris σε καθαρό REST και γράφω για τις βαρετές λεπτομέρειες που είναι πραγματικά σημαντικές.

// δημιούργησε πάνω σε αυτό

Αυτή η ίδια Swiss Ephemeris που υπάρχει στο Solar Fire - σε 4 γραμμές κώδικα.

Δωρεάν κλειδί χωρίς κάρτα. 5.000 αιτήματα ανά μήνα μέχρι την πρώτη πληρωμή.

Λήψη API-κλειδιού → Τεκμηρίωση

Γρήγορη εκκίνηση API αστρολογίας: TypeScript και Python σε 5 λεπτά

Βήμα 1: Πάρε το API‑key (30 δευτερόλεπτα)

Βήμα 2: Εγκατέστησε το SDK

TypeScript

Python

Βήμα 3: Πρώτος γενέθλιος χάρτης

TypeScript

Python

Τι επιστρέφει το API

πλανήτες

σπίτια

aspects

chartSect

Τι έπεται

Κόστος σε credits

Διαχείριση σφαλμάτων

Και αυτό είναι όλο

Αυτή η ίδια Swiss Ephemeris που υπάρχει στο Solar Fire - σε 4 γραμμές κώδικα.

Περισσότερα από το blog όλες οι δημοσιεύσεις →

Free Astrology API: Which One Has the Best Free Tier in 2026?

Horoscope API Tutorial: Build a Daily Horoscope Feature

Natal Chart API in PHP: SDK + Laravel Example