AstroWay API Belgeleri

AstroWay API хаб документації. 761 eндпоінтів temelinde Swiss Ephemeris, otomatik OpenAPI-destek, Postman ve Insomnia için hazır koleksiyonlar, TypeScript, Python ve PHP için resmi SDK’ler, MCP Claude/Cursor için sunucu.

Referans

API Referansı Tam bir katalog 761 eндпоінтів: parametreler, cevap şemaları, hata kodları. Her yayın için OpenAPI spec'i ile oluşturulur.

OpenAPI spesifikasyonu Makinaya anımlanabilir spesifikasyon. Postman/Insomnia'ya import edin veya openapi-generator aracılığıyla kendi SDK'nuzu oluşturun.

Postman koleksiyonu Her eндпоін için örnekler içeren hazır koleksiyon.

Eндпоін başına maliyet Her eндпоін için kredi maliyeti - 0'dan 500 krediye kadar.

Başlangıç

Hızlı Başlangıç Kayıt ol, anahtar al, ilk çağrıya 5 dakika içinde.

Kimlik Doğrulama X-Api-Key vs Bearer, canlı (aw_live_*) vs sandbox (aw_test_*), JWT için panel.

Krediler ve Limitler Kredi havuzu, aylık kota, plana göre rate limitler.

Dil Destekleri 21 aktif dil. `Accept-Language` (metin içeriği) aracılığıyla yanıtın yerelleştirilmesi.

SDK ve Entegrasyonlar

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

Python SDK Resmi paket `astroway` PyPI'de. Sinc ve async istemciler, Python 3.9+.

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

MCP Server Claude Desktop, Cursor ve diğer AI-agenler için Model Context Protocol sunucusu `@astroway/mcp`.

Mühendislik

Hesaplama Düzenliği Swiss Ephemeris arc-second doğruluk. CI-snapshot testleri NASA Eclipse Katalog'u karşılaştırmak.

Hatalar Hata kodları, HTTP durumları ve hata paketi yapısı.

İdempotency POST için güvenli yeniden deneme için `Idempotency-Key` başlığı.

Sürümleme Nasıl sürümleme yapılıyor, uyumsuzluk nasıl oluşuyor, değişiklikler nasıl okunuyor.

Senaryolar ve Örnekler

Ürün Özetleri Dört ürün grubu - Doğum Kartı, İnsan Tasarımı, Synastry, Horoskop.

Vedik Astroloji 354+ eндпоін için Vedik - Vargas, dashas (8 sistem), Panchang, Shadbala, Yogas, Doshas.

Örnek Kodlar Doğum Kartı, Synastry, Transit, İnsan Tasarımı, MCP için hazır örnekler.

Kullanım Senaryoları AstroWay uygulamaları, AI-agenler ve dating platformları için entegrasyon senaryoları.