Hartă natală

Endpoint-ul POST /v1/chart este baza majorității cererilor. Returnează o hartă natală completă: pozițiile planetelor, cuspidii ale caselor, aspecte între planete, sectoarele hărții. Cost: 20 de credite (Tier 2).

Parametrii cererii

Parametru	Tip	Obligatoriu	Descriere
date	string	Da	Data nașterii YYYY-MM-DD
time	string	Da	Ora nașterii HH:mm:ss sau HH:mm (se citește ca HH:mm:00)
timezoneOffset	number	Da	Decalajul față de UTC în ore (ex. 2 pentru Kiev vara)
latitude	number	Nu (0)	Latitudinea în grade zecimale
longitude	number	Nu (0)	Longitudinea în grade zecimale
houseSystem	string	Nu (P)	Sistemul de case: P Placidus, K Koch, W Whole Sign, E Equal și altele
name	string	Nu	Numele (returnat în răspuns)
city	string	Nu	Orașul (returnat în răspuns)
zodiacType	string	Nu	tropical (implicit) sau sidereal
cosmogram	boolean	Nu	true - fără case (când locul este necunoscut)

Exemplu de cerere

Hartă natală pentru Kiev, 14 iulie 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

Exemplu de răspuns

{
  "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"
}

Mențiune

Răspunsul este scurtat pentru claritate. Răspunsul complet include 13 corpuri, 12 cuspidii ale caselor și toate aspectele dintre ele. În câmpul name al fiecărui corp se află numele din Swiss Ephemeris, nu cel astrologic: Sun, Moon, Mercury, Venus, Mars, Jupiter, Saturn, Uranus, Neptune, Pluto, true Node (Nodul Nordic, adevărat), mean Apogee (Lilith, medie), Chiron. Nodul Sudic nu este returnat ca corp separat: este true Node plus 180°.

Nume în limba ta

Adaugă ?lang= pentru a obține numele planetelor, semnelor zodiacale și aspectelor în această limbă, alături de identificatorii englezești care nu se schimbă. Funcționează oricare dintre cele 21 de limbi, de exemplu germana:

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" }
  }
}

Fără ?lang= în răspuns nu există blocul localized.

Sisteme de case

Cod	Sistem	Notă
P	Placidus	Implicit, cea mai populară
K	Koch	Populară în Germania
W	Whole Sign	Clasic elenist
E	Equal	Egal de la ASC
R	Regiomontanus	Astrologie horară
C	Campanus	Sistem spațial
T	Topocentric	Polich-Page
B	Alcabitius	Tradiție medievală

Lista completă cu 15 sisteme se găsește în API reference.

Cosmogramă (fără locul nașterii)

Dacă ora nașterii este cunoscută, dar locul - nu, trimite "cosmogram": true. Casele și ASC/MC nu sunt calculate, costul este același (20 de credite).

Antetele răspunsului

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

Următorul

• Sinastrie: compatibilitatea a două hărți
• Tranzite: overlay tranzitoriu și calendar de evenimente
• Human Design: hartă HD completă
• API reference complet: toți 771 endpoint-urile