AstroWay API Dokümantasyonu

Last updated 25 Eyl 2026 Markdown olarak aç Aracı Kurulumu

AstroWay API teknik dokümantasyon merkezi. Swiss Ephemeris tabanlı 781 endpoint, makine tarafından okunabilir OpenAPI spesifikasyonu, Postman ve Insomnia için hazır koleksiyonlar, TypeScript, Python ve PHP için resmi SDK’lar, Claude/Cursor için MCP sunucusu.

Referans

API Reference 781 endpoint'in eksiksiz kataloğu: parametreler, yanıt şemaları, hata kodları. Her sürümde OpenAPI spesifikasyonundan üretilir.

OpenAPI specification Makine tarafından okunabilir spesifikasyon. Postman/Insomnia'ya içe aktarın veya openapi-generator ile kendi SDK'nızı üretin.

Postman collection Her endpoint için örnekler içeren, içe aktarmaya hazır koleksiyon.

Per-endpoint cost Her endpoint'in kredi cinsinden maliyeti: 0 ile 500 kredi arası.

Başlangıç

Hızlı başlangıç Kaydolun, anahtarınızı alın, ilk çağrınızı 5 dakikada yapın.

Kimlik doğrulama X-Api-Key vs Bearer, live (aw_live_*) vs sandbox (aw_test_*), dashboard için JWT.

Krediler ve limitler Kredi havuzu, aylık kotalar, plana göre rate limit'ler.

Dil desteği 21 aktif dil. Yanıtların `Accept-Language` ile yerelleştirilmesi (metin içeriği).

SDK ve entegrasyonlar

TypeScript SDK npm'de resmi `@astroway/sdk` paketi. ESM, Node 20+, tarayıcı uyumlu.

Python SDK PyPI'da resmi `astroway` paketi. Sync ve async istemciler, Python 3.9+.

PHP SDK Packagist'te resmi `astroway/sdk` paketi. PSR-18 HTTP, PHP 8.1+.

MCP server `@astroway/mcp`: Claude Desktop, Cursor ve diğer AI ajanları için Model Context Protocol sunucusu.

Mühendislik

Hesaplama doğruluğu Swiss Ephemeris ile yay saniyesi hassasiyeti. NASA Eclipse Catalog'a karşı CI snapshot testleri.

Hatalar Hata kodlarının, HTTP durumlarının listesi ve error envelope yapısı.

Idempotency POST isteklerinde güvenli retry için `Idempotency-Key` başlığı.

Sürümleme Sürümleri nasıl artırıyoruz, uyumluluğu ne bozar, changelog nasıl okunur.

Senaryolar ve örnekler

Ürünlere genel bakış Dört ürün grubu: Birth Chart, Human Design, Synastry, Horoscope.

Vedik astroloji Vedic için 354'ten fazla endpoint: Vargas, dashas (8 sistem), Panchang, Shadbala, Yogas, Doshas.

Kod örnekleri Doğum haritası, sinastri, transitler, Human Design ve MCP için hazır kod parçacıkları.

Use cases Astroloji uygulamaları, AI ajanları ve flört platformları için entegrasyon senaryoları.

Düzenleme öner