🕓 2026-04-14 tarihinde kaydedilmiş, 2026-05-09 tarihinde güncellenmiştir. TS / Python / PHP SDK artık halka açık depolarda mevcuttur —
@astroway/sdk(npm),astroway(PyPI),astroway/sdk(Packagist). Ayrıntılar için changelog.
Natal haritanı kod kullanarak hesaplamak istiyorsun. İşte en kısa yol — 5 dakikada sıfırdan çalışır duruma gelen JSON.
Adım 1: API Anahtarını Al (30 saniye)
Section titled “Adım 1: API Anahtarını Al (30 saniye)”api.astroway.info/dashboard/sign-up adresine kaydol. Ücretsiz plan: 10 000 kredi / ay. Kart gerekmez.
Dashboard bölümünde “Create key” → “Production” → kopyala. Anahtarlar aw_live_aB3xY7pQ9rN2mK4jH8vC5tL6wZ1fD0eR biçiminde görünür.
İpucu: Geliştirme sırasında kredi düşülmeyen aw_test_ ön ekli sandbox anahtarları da mevcuttur.
Adım 2: SDK’yı Kur
Section titled “Adım 2: SDK’yı Kur”TypeScript
Section titled “TypeScript”npm install @astroway/sdkPython
Section titled “Python”pip install astrowayHer iki SDK da tüm 723 endpoint’lerini tip hóa edilmiş istek ve yanıtlarla kapsar.
Adım 3: İlk Natal Harita
Section titled “Adım 3: İlk Natal Harita”TypeScript
Section titled “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, Kiev yaz saati latitude: 50.4501, longitude: 30.5234, houseSystem: 'P', // Placidus});
console.log(`Güneş: ${chart.planets[0].sign} at ${chart.planets[0].longitude}°`);console.log(`ASC: ${chart.houses.ascendant}°`);console.log(`Aspektler: ${chart.aspects.length}`);Çalıştır:
ASTROWAY_API_KEY=aw_live_... npx tsx chart.tsPython
Section titled “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"Güneş: {chart['planets'][0]['sign']} at {chart['planets'][0]['longitude']}°")print(f"ASC: {chart['houses']['ascendant']}°")print(f"Aspektler: {len(chart['aspects'])}")Çalıştır:
ASTROWAY_API_KEY=aw_live_... python3 chart.pyAPI’nin Döndürdüğü Değerler
Section titled “API’nin Döndürdüğü Değerler”Dönen JSON nesnesi dört temel parçadan oluşur:
planets
Section titled “planets”12 nesneden (Güneş, Ay, Merkür, Venüs, Mars, Jüpiter, Satürn, Uranüs, Neptün, Plüton, Kuzey Düğüm, Chiron) oluşan bir dizi:
{ "name": "Güneş", "longitude": 111.87, // eklips döndüğü boylam derecelerinde "latitude": 0.0, "speed": 0.955, // günlük hız (negatif = gerileyen) "sign": "yengeç", "signIndex": 3, "house": 10, "retrograde": false}houses
Section titled “houses”12 evin küspitleri ve ayrıca asc ve MC:
{ "system": "P", "cusps": [12.34, 43.21, ...], // 12 değer "ascendant": 12.34, "mc": 280.12}aspects
Section titled “aspects”Gezegenler arasındaki aspektlerin bir dizisi:
{ "planet1": "Güneş", "planet2": "Ay", "type": "sextile", // conjunction, opposition, trine, square, sextile, quincunx "orb": 1.36, // sapma derecelerinde "applying": true}chartSect
Section titled “chartSect”"diurnal" (Güneş doğum anında ufuk üzerindeyse) veya "nocturnal" (ufuk altında). Klasik astrolojide kullanılır.
Sonraki Adımlar
Section titled “Sonraki Adımlar”Deneyebileceğiniz diğer şeyler:
Sınastri — iki kişinin uyumu:
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(`Uyumluluk puanı: ${synastry.compatibility.score}/100`);Natal haritanız上的 güncel transitler:
const transits = await client.transits({ // doğum verileri date: '1990-07-14', time: '14:30:00', timezoneOffset: 3, latitude: 50.4501, longitude: 30.5234, // transit tarihi transitDate: '2026-04-14',});Gerçek transitlerle günlük burç:
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);Tam İnsan Tasarımı haritası:
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}`);Kredi Maliyeti
Section titled “Kredi Maliyeti”- Natal harita (
/chart): 20 kredi - Sınastri: 50 kredi
- Transitler: 50 kredi
- Günlük burç: 20 kredi
- İnsan Tasarımı: 50 kredi
Ücretsiz plan: 10 000 kredi / ay = 500 natal harita, veya 200 sınastri, veya karma yük.
Hata İşleme
Section titled “Hata İşleme”Her yanıt kredi bilgilerini içeren başlıkları içerir:
X-Credits-Used: 20X-Credits-Remaining: 4980X-Credits-Reset: 2026-05-01T00:00:00ZKrediler bittiğinde — 402 Payment Required alırsın. Rate limit’ine (Ücretsiz: 10 istek / dk) ulaştığında — 429 Too Many Requests ile Retry-After başlığı alırsın.
SDK tip hóa edilmiş hatalar atar, bunları yakalayabilirsin:
try { const chart = await client.chart({ ... });} catch (err) { if (err.code === 'credits_exhausted') { console.log('Planı yükselt veya sıfırlanmasını bekle'); } else if (err.code === 'rate_limit_exceeded') { console.log(`Tekrar dene ${err.retryAfter} saniye sonra`); }}Ve İşte Bütünü
Section titled “Ve İşte Bütünü”Şimdi sende:
- Çalışan API anahtarı var
- SDK kurulu
- İlk natal haritan var
- Sınastri, transitler, burçlar eklemek için yeterli örnek var
Daha fazla oku:
- Tam kılavuz «nereden başlayacağım» — daha fazla ayrıntı
- Örnek: natal harita — daha derin bir yürüyüş
- API referansı — tüm 723 endpoint’leri
Solar Fire'daki aynı Swiss Ephemeris — 4 satır kodla.
Kart gerekmeden ücretsiz anahtar. İlk ödemeye kadar ayda 5.000 istek.