Natal Harita

POST /v1/chart uç noktası, çoğu isteğin temelini oluşturur. Tam bir doğum haritasını döndürür: gezegen konumları, ev cusps’ları, gezegenler arasındaki açılar ve haritanın sect’ini içerir. Ücret: 20 kredi (Tier 2).

İstek Parametreleri

Parametre	Tür	Zorunlu	Açıklama
date	string	Evet	Doğum tarihi YYYY-MM-DD
time	string	Evet	Doğum zamanı HH:mm:ss
timezoneOffset	number	Evet	UTC’den saat cinsinden sapma (örn. yazın Kiev için 2)
latitude	number	Hayır (0)	Enlem, ondalıklı derece cinsinden
longitude	number	Hayır (0)	Boylam, ondalıklı derece cinsinden
houseSystem	string	Hayır (P)	Ev sistemi: P Placidus, K Koch, W Whole Sign, E Equal ve diğerleri
name	string	Hayır	İsim (yanıt içinde döndürülür)
city	string	Hayır	Şehir (yanıt içinde döndürülür)
zodiacType	string	Hayır	tropical (varsayılan) veya sidereal
cosmogram	boolean	Hayır	true — evler olmadan (yer bilinmiyorsa)

İstek Örneği

Kiev için doğum haritası, 14 Temmuz 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 chart = await res.json();
console.log(chart.planets[0]); // Güneş konumu

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()
print(chart['planets'][0])  # Güneş konumu

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);
print_r($chart['planets'][0]); // Güneş konumu

Yanıt Örneği

{
  "input": {
    "date": "1990-07-14",
    "time": "14:30:00",
    "timezoneOffset": 3,
    "latitude": 50.4501,
    "longitude": 30.5234,
    "houseSystem": "P"
  },
  "julianDay": 2448087.979166,
  "siderealTime": 8.234,
  "planets": [
    {
      "name": "Sun",
      "longitude": 111.87,
      "latitude": 0.0,
      "speed": 0.955,
      "sign": "cancer",
      "signIndex": 3,
      "house": 10,
      "retrograde": false
    },
    {
      "name": "Moon",
      "longitude": 87.23,
      "latitude": -4.2,
      "speed": 13.3,
      "sign": "gemini",
      "signIndex": 2,
      "house": 8,
      "retrograde": false
    }
  ],
  "houses": {
    "system": "P",
    "cusps": [12.34, 43.21, 72.56, 100.12, 130.45, 162.78, 192.34, 223.21, 252.56, 280.12, 310.45, 342.78],
    "ascendant": 12.34,
    "mc": 280.12
  },
  "aspects": [
    {
      "planet1": "Sun",
      "planet2": "Moon",
      "type": "sextile",
      "orb": 1.36,
      "applying": true
    }
  ],
  "chartSect": "diurnal"
}

Not

Yanıt açıklayıcı olması için kısaltılmıştır. Tam yanıt tüm 12 gezegeni (Sun, Moon, Mercury, Venus, Mars, Jupiter, Saturn, Uranus, Neptune, Pluto + North Node, Chiron), 12 ev cusps’ını ve aralarındaki tüm açılar içerir.

Ev Sistemleri

Kod	Sistem	Not
P	Placidus	Varsayılan, en popüler
K	Koch	Almanya’da popüler
W	Whole Sign	Klasik Helenistik
E	Equal	ASC’den eşit
R	Regiomontanus	Horary astroloji
C	Campanus	Mekansal sistem
T	Topocentric	Polich-Page
B	Alcabitius	Ortaçağ geleneği

Tüm 15 sistemin listesi — API referansı.

Kozmogram (Doğum yeri bilinmiyorsa)

Doğum zamanı biliniyorsa ancak yer bilinmiyorsa, "cosmogram": true gönder. Evler ve ASC/MC hesaplanmaz, krediler aynı (20).

Yanıt Başlıkları

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

Sonraki Adımlar

• Sinastride — iki haritanın uyumluluğu
• Transitler — transit overlay ve olay takvimi
• Human Design — tam HD haritası
• Tam API referansı — tüm 723 uç noktaları