AstroWay/api v2.190.0 · tr
tüm sistemler normal

Katalog haritası: AstroWay'in 700+ endpoint'i nasıl düzenlenmiştir

API 57 grupta 700'den fazla endpoint'e büyüdü - natal haritalardan BaZi, jeomantiye ve SVG harita render'ına kadar. Katalogun domain'lere nasıl bölündüğünü, tüm çağrıların tek bir desenle nasıl yürütüldüğünü ve gerekli endpoint'i hızlıca nasıl bulacağınızı inceliyoruz.

AstroWay Kataloğu halihazırda 758 uç nokta ve 57 grup içeriyor. Bu ölçekte, bir entegratörün asıl sorusu “kapsam yeterli mi” değil, “nasıl kaybolmam”dır. Bu makale bir harita: kataloğun alanlara nasıl bölündüğünü ve ihtiyacın olanı bir dakikada nasıl bulacağını gösteriyor.

Alan ne olursa olsun, her hesaplama uç noktası aynı biçime sahiptir:

POST /v1/{domain}/{calc}
X-Api-Key: aw_live_...
Content-Type: application/json

Gövde, doğum verilerini (tarih, saat, koordinatlar) veya tekniğe özgü parametreleri içeren bir JSON’dur. Yanıt her zaman { "ok": true, "data": {...} } veya { "ok": false, "error": {...} } şeklindedir. GraphQL yok, alana özel ayrı bir auth-flow yok: X-Api-Key başlığında tek bir anahtar, tek bir yanıt formatı.

Bu, natal harita için yazdığın sarmalayıcının BaZi ve rünler için de uygun olduğu anlamına gelir; sadece yol ve gövde şeması değişir.

Katalog büyük alanlar halinde gruplandırılmıştır. İşte gerçek sayılarla bir harita (sayılar her derlemedeki manifestten alınır, bu yüzden burada her zaman günceldir):

AlanUç Nokta Sayısıİçerik
Batı Astrolojisi182Natal harita, açılar, yücelikler, prognostik (transitler, ilerlemeler, direksiyonlar), horary, 4 Helenistik okul, modern psikolojik, evrimsel, kozmobiyoloji
Vedik174En büyük alan: nakshatras, dashas, divisional haritalar (varga), yogas, dosha, Jaimini, KP, ashtakavarga, shadbala
Human Design12Bodygraph, kanallar, kapılar, tip/profil/otorite, enkarnasyon haçı
Tarot66Üç deste: Rider-Waite-Smith, Marseille, Lenormand - açılımlar, anlamlar, kombinasyonlar
Numeroloji5010 hesaplamalı 5 sistem (Pisagor, Keldani, iki Kabalistik, Vedik)
Çin + Maya55BaZi (Dört Sütun), Zi Wei Dou Shu, Çin zodyağı ve Feng Shui, Maya takvimleri
Kehanet31Geomancy (Agrippa), Elder Futhark rünleri, el falı (Cheiro), I Ching
Uygulamalı Nişler51Wellness, hayvan astrolojisi, iş, finans, aile
Raporlar23Hazır yorumlar (natal, sinastri), HTML/PDF formatında, white-label markalama ile
Render14SVG/PNG harita çarkları, bodygraph, transit halkaları - kendi frontend’in olmadan
Dev Araçları44Webhooks, gerçek zamanlı akış, gömülebilir widget’lar, white-label

Geri kalanlar - AI yorumları, burçlar, referans uç noktaları (burçlar, gezegenler, açılar) ve sistem (health, usage, openapi) uç noktalarıdır.

174 Vedik uç noktası, tüm Batı bölümünden daha fazladır. Nedeni basit: Vedik gelenek daha resmiyet kazanmıştır. Batı astrolojisinin tek bir ev seti varken, Vedik astrolojisinde 16 divisional harita (varga), birkaç dasha sistemi, net kurallara sahip onlarca yoga bulunur. Bunların her biri, belirlenmiş bir sonuca sahip ayrı bir uç noktadır.

Hint pazarı için geliştiriyorsan, bu bir eklenti değil, ürünün çekirdeğidir.

Tekniğin egzotikliği ne olursa olsun, gezegen konumları Swiss Ephemeris (WASM) üzerinde tek bir çekirdek tarafından hesaplanır. Aynı çekirdek hem uygulamamızın tarayıcısında hem de API sunucusunda çalışır - tek bir kod tabanı, hiçbir farklılık yok. Hesaplama uç noktaları, her PR’da referans kaynaklarla karşılaştırılan 873 snapshot testi ile kapsanmıştır. Daha fazla bilgi için CI doğruluğu hakkındaki ayrı makaleye bak.

En hızlıdan başlayarak üç yol:

  1. OpenAPI Referansı - /docs/api/ doğrudan openapi.json üretim spesifikasyonundan oluşturulur. Kenar çubuğundaki gruplar = yukarıdaki alanlar. Her uç noktanın bir gövde şeması, bir örneği ve bir “dene” düğmesi vardır.
  2. MCP Kataloğu - Claude veya Cursor kullanıyorsan, tüm katalog mcp.astroway.info üzerinden bir araç seti olarak mevcuttur. Aracı, açıklamaya göre doğru uç noktayı kendi başına bulur.
  3. Spesifikasyonda Arama - curl https://api.astroway.info/v1/openapi.json tamamen makine tarafından okunabilir bir sözleşme döndürür. Kendi istemcini kod üretmek için kullanışlıdır.

dashboard/sign-up adresindeki anahtar, ayda 10.000 kredi verir - bu, onlarca alanı gezmek ve hangisinin sana uygun olduğunu anlamak için yeterlidir. Kataloğu tamamen öğrenmene gerek yok: kendi alanını al, gerisi ihtiyacın olduğunda bekleyecektir.

MakSeong · AstroWay

I build the AstroWay API: Swiss Ephemeris on a clean REST surface, and I write about the dull parts that turn out to matter.

// bunu kullanarak inşa et

Solar Fire'daki aynı Swiss Ephemeris - 4 satır kodla.

Kart gerekmeden ücretsiz anahtar. İlk ödemeye kadar ayda 5.000 istek.

Daha fazla blog yazısı tüm yazılar →

Engineering 2026-07-15

Üç resmi SDK: TypeScript, Python, PHP ham curl yerine

Ham HTTP çalışır, ancak tiplenmiş istemci saatler tasarruf ettirir: yol otomatik tamamlaması, istek ve yanıt tipleri, 408/409/429/5xx için yerleşik retry ve Stainless tarzı hata hiyerarşisi. Üç resmi SDK'yı inceliyoruz - @astroway/sdk (npm), astroway (PyPI), astroway/sdk (Packagist) - ve bunların tek bir OpenAPI sözleşmesinden nasıl üretildiğini.

Industry 2026-06-05

Free Astrology API: Which One Has the Best Free Tier in 2026?

A side-by-side of free tiers across the major astrology APIs - credits, request caps, card requirements - and how much you can actually build for free.

Engineering 2026-06-05

Horoscope API Tutorial: Build a Daily Horoscope Feature

Add daily, weekly and monthly horoscopes to your app via API - sign-based text vs transit-based personalization - with TypeScript and Python code.