Γεννηματολογικός χάρτης

Το endpoint POST /v1/chart - η βάση των περισσότερων αιτήσεων. Επιστρέφει το πλήρες γενέθλιο χάρτη: θέσεις πλανητών, κουσπίνδες οίκων, όψεις μεταξύ πλανητών, το τμήμα του χάρτη. Κόστος: 20 credits (Tier 2).

Παράμετροι αιτήματος

Παράμετρος	Τύπος	Απαιτείται	Περιγραφή
date	string	Ναι	Ημερομηνία γέννησης YYYY-MM-DD
time	string	Ναι	Ώρα γέννησης HH:mm:ss ή HH:mm (διαβάζεται ως HH:mm:00)
timezoneOffset	number	Ναι	Μετατόπιση από UTC σε ώρες (π.χ. 2 για την Κίεβο το καλοκαίρι)
latitude	number	Όχι (0)	Γεωγραφικό πλάτος σε δεκαδικούς βαθμούς
longitude	number	Όχι (0)	Γεωγραφικό μήκος σε δεκαδικούς βαθμούς
houseSystem	string	Όχι (P)	Σύστημα οίκων: P Placidus, K Koch, W Whole Sign, E Equal και άλλα
name	string	Όχι	Όνομα (επιστρέφεται στην απάντηση)
city	string	Όχι	Πόλη (επιστρέφεται στην απάντηση)
zodiacType	string	Όχι	tropical (προεπιλογή) ή sidereal
cosmogram	boolean	Όχι	true - χωρίς οίκους (όταν η τοποθεσία είναι άγνωστη)

Παράδειγμα αιτήματος

Γενέθλιος χάρτης για την Κίεβο, 14 Ιουλίου 1990, 14:30:

cURL

curl -X POST https://api.astroway.info/v1/chart \
  -H "X-Api-Key: aw_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "date": "1990-07-14",
    "time": "14:30:00",
    "timezoneOffset": 3,
    "latitude": 50.4501,
    "longitude": 30.5234,
    "houseSystem": "P"
  }'

Node.js

const res = await fetch('https://api.astroway.info/v1/chart', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-Api-Key': process.env.ASTROWAY_API_KEY!,
  },
  body: JSON.stringify({
    date: '1990-07-14',
    time: '14:30:00',
    timezoneOffset: 3,
    latitude: 50.4501,
    longitude: 30.5234,
    houseSystem: 'P',
  }),
});
const { data: chart } = await res.json();
console.log(chart.planets[0]); // Sun position

Python

import os, requests

r = requests.post(
    'https://api.astroway.info/v1/chart',
    headers={'X-Api-Key': os.environ['ASTROWAY_API_KEY'], 'Content-Type': 'application/json'},
    json={
        'date': '1990-07-14',
        'time': '14:30:00',
        'timezoneOffset': 3,
        'latitude': 50.4501,
        'longitude': 30.5234,
        'houseSystem': 'P',
    },
)
chart = r.json()['data']
print(chart['planets'][0])  # Sun position

PHP

<?php
use GuzzleHttp\Client;

$client = new Client(['base_uri' => 'https://api.astroway.info/v1/']);
$r = $client->post('chart', [
    'headers' => ['X-Api-Key' => getenv('ASTROWAY_API_KEY')],
    'json' => [
        'date' => '1990-07-14',
        'time' => '14:30:00',
        'timezoneOffset' => 3,
        'latitude' => 50.4501,
        'longitude' => 30.5234,
        'houseSystem' => 'P',
    ],
]);

$chart = json_decode($r->getBody(), true)['data'];
print_r($chart['planets'][0]); // Sun position

Παράδειγμα απάντησης

{
  "input": {
    "name": "",
    "date": "1990-07-14",
    "time": "14:30:00",
    "timezoneOffset": 3,
    "latitude": 50.4501,
    "longitude": 30.5234,
    "houseSystem": "P",
    "city": "",
    "cosmogram": false
  },
  "julianDay": 2448086.979167,
  "siderealTime": 6.971672,
  "planets": [
    {
      "id": 0,
      "name": "Sun",
      "longitude": 111.77244,
      "latitude": 0.000162,
      "distance": 1.016462,
      "speedLong": 0.953753,
      "isRetrograde": false,
      "declination": 21.681363
    },
    {
      "id": 1,
      "name": "Moon",
      "longitude": 9.061363,
      "latitude": 4.639701,
      "distance": 0.002511,
      "speedLong": 13.770219,
      "isRetrograde": false,
      "declination": 7.854711
    }
  ],
  "houses": {
    "system": "P",
    "cusps": [
      212.0953,
      239.7536,
      274.2018,
      312.6334,
      346.2069,
      12.1755,
      32.0953,
      59.7536,
      94.2018,
      132.6334,
      166.2069,
      192.1755
    ],
    "ascendant": 212.0953,
    "mc": 132.6334
  },
  "aspects": [
    {
      "planet1": "Sun",
      "planet2": "Jupiter",
      "type": {
        "name": "Conjunction",
        "angle": 0,
        "isMajor": true
      },
      "orb": 0.548,
      "isApplying": true
    }
  ],
  "chartSect": "diurnal"
}

Σημείωση

Η απάντηση είναι συντομευμένη για σαφήνεια. Η πλήρης απάντηση περιλαμβάνει 13 σώματα, 12 κουσπίνδες οίκων και όλες τις όψεις μεταξύ τους. Στο πεδίο name κάθε σώματος εμφανίζεται το όνομα από το Swiss Ephemeris, όχι το αστρολογικό: Sun, Moon, Mercury, Venus, Mars, Jupiter, Saturn, Uranus, Neptune, Pluto, true Node (Βόρειος κόμβος, αληθινός), mean Apogee (Λίλιθ, μέσος), Chiron. Ο Νότιος κόμβος δεν επιστρέφεται ως ξεχωριστό σώμα: είναι το true Node συν 180°.

Ονόματα στη δική σου γλώσσα

Πρόσθεσε ?lang= για να λάβεις τα ονόματα των πλανητών, των ζωδίων και των όψεων σε αυτή τη γλώσσα δίπλα στους αγγλικούς αναγνωριστικούς που δεν αλλάζουν. Οποιαδήποτε από τις 21 γλώσσες λειτουργεί, π.χ. τα γερμανικά:

curl -X POST "https://api.astroway.info/v1/chart?lang=de" \
  -H "X-Api-Key: aw_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{ "date": "1990-07-14", "time": "14:30:00", "timezoneOffset": 3, "latitude": 50.4501, "longitude": 30.5234, "houseSystem": "P" }'

{
  "localized": {
    "planets": { "Sun": "Sonne", "Moon": "Mond", "Mercury": "Merkur" },
    "signs": { "cancer": "Krebs", "leo": "Löwe", "aries": "Widder" },
    "aspects": { "Conjunction": "Konjunktion", "Opposition": "Opposition" }
  }
}

Χωρίς ?lang= το μπλοκ localized στην απάντηση δεν υπάρχει.

Συστήματα οίκων

Κωδικός	Σύστημα	Σημείωση
P	Placidus	Προεπιλογή, το πιο δημοφιλές
K	Koch	Δημοφιλές στη Γερμανία
W	Whole Sign	Κλασική ελληνο-ιστορική
E	Equal	Ίσες από το ASC
R	Regiomontanus	Χωραρική αστρολογία
C	Campanus	Χωρική σύστημα
T	Topocentric	Polich-Peij
B	Alcabitius	Μεσαιωνική παράδοση

Πλήρης λίστα με 15 συστήματα - στο API reference.

Κοσμογράφημα (χωρίς τόπο γέννησης)

Αν η ώρα γέννησης είναι γνωστή, αλλά η τοποθεσία όχι, στείλε "cosmogram": true. Οι οίκοι και το ASC/MC δεν υπολογίζονται, τα credits παραμένουν τα ίδια (20).

Κεφαλίδες της απάντησης

X-Credits-Used: 20
X-Credits-Remaining: 4980
X-Credits-Reset: 2026-05-01T00:00:00Z
X-Request-Id: 8aec43e9bc749b37e998a489bbad1757

Επόμενο

• Συναστρία: συμβατότητα δύο χαρτών
• Μεταβάσεις: επικάλυψη μεταβάσεων και ημερολόγιο γεγονότων
• Human Design: πλήρης HD-χάρτης
• Πλήρης API reference: όλα τα 771 endpoints