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

🕓 Δημοσίευση από 2026-04-14, ενημερώθηκε 2026-05-09. Τα TS / Python / PHP SDK βρίσκονται τώρα σε δημόσια μητρώα — @astroway/sdk (npm), astroway (PyPI), astroway/sdk (Packagist). Περισσότερες λεπτομέρειες στο changelog.

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

Βήμα 1: Απόκτησε το κλειδί API (30 δευτερόλεπτα)

Δημιούργησε έναν λογαριασμό στο api.astroway.info/dashboard/sign-up. Δωρεάν πρόγραμμα: 10.000 πιστώσεις / μήνα. Χωρίς κάρτα.

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

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

Βήμα 2: Εγκατάσταση SDK

TypeScript

npm install @astroway/sdk

Python

pip install astroway

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

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

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, θερινή ώρα στο Κίεβο
  latitude: 50.4501,
  longitude: 30.5234,
  houseSystem: 'P',       // Placidus
});

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

Εκτέλεσε:

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

Εκτέλεσε:

ASTROWAY_API_KEY=aw_live_... python3 chart.py

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

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

planets

Ένας πίνακας με 12 αντικείμενα (Sun, Moon, Mercury, Venus, Mars, Jupiter, Saturn, Uranus, Neptune, Pluto, North Node, Chiron):

{
  "name": "Sun",
  "longitude": 111.87,      // εκλειπτικό μήκος σε μοίρες
  "latitude": 0.0,
  "speed": 0.955,           // μοίρες ανά ημέρα (αρνητικό = ανάδρομο)
  "sign": "cancer",
  "signIndex": 3,
  "house": 10,
  "retrograde": false
}

houses

Οι κορυφές των οίκων (12 σύνολο), καθώς και asc και MC:

{
  "system": "P",
  "cusps": [12.34, 43.21, ...],   // 12 τιμές
  "ascendant": 12.34,
  "mc": 280.12
}

aspects

Ένας πίνακας με τις όψεις μεταξύ των πλανητών:

{
  "planet1": "Sun",
  "planet2": "Moon",
  "type": "sextile",        // conjunction, opposition, trine, square, sextile, quincunx
  "orb": 1.36,              // απόκλιση από την ακριβή τιμή σε μοίρες
  "applying": 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}`);

Κόστος σε πιστώσεις

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

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

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

Κάθε απάντηση περιλαμβάνει κεφαλίδες με τις πιστώσεις:

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

Όταν τελειώσουν οι πιστώσεις — θα λάβεις 402 Payment Required. Όταν ξεπεραστεί το όριο αιτημάτων (Δωρεάν: 10 αιτήματα / λεπτό) — 429 Too Many Requests με κεφαλίδα Retry-After.

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

try {
  const chart = await client.chart({ ... });
} catch (err) {
  if (err.code === 'credits_exhausted') {
    console.log('Ανέβασε το πρόγραμμα ή περίμενε την επαναφορά');
  } else if (err.code === 'rate_limit_exceeded') {
    console.log(`Ξαναπροσπάθησε σε ${err.retryAfter} δευτερόλεπτα`);
  }
}

Και αυτό ήταν!

Τώρα έχεις:

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

Διάβασε περισσότερα:

Ο πλήρης οδηγός «από πού να ξεκινήσεις» — περισσότερες λεπτομέρειες
Παράδειγμα: γενέθλιος χάρτης — πιο αναλυτικός οδηγός
Αναφορά API — όλα τα 723 endpoints

AstroWay team

Η μηχανική ομάδα του AstroWay API. Τυλίγουμε το Swiss Ephemeris σε καθαρό REST και γράφουμε για τις βαρετές λεπτομέρειες που όμως έχουν σημασία.

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

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

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

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

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

Βήμα 1: Απόκτησε το κλειδί API (30 δευτερόλεπτα)

Βήμα 2: Εγκατάσταση SDK

TypeScript

Python

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

TypeScript

Python

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

planets

houses

aspects

chartSect

Τι ακολουθεί

Κόστος σε πιστώσεις

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

Και αυτό ήταν!

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

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

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)