Mühendislik notları.
Efemeris doğruluğu, hesaplama mimarisi, MCP protokolü ve dokümanlara sığmayan her şey hakkında.
AI ajanları için hazırlanmış dokümantasyon, sadece insanlar için değil
Klasyk dokümantasyon insan gözleri için yapılmış: güzel HTML, kod vurgulama, navigasyon. Ancak docs trafiğinin yarısı artık ajanlar ve asistanlar, plain-text ihtiyacı olan, render değil. Eklediğimiz şeyler: her sayfanın .md ikizi, llms.txt, makine okunabilir spesifikasyonlar, dropdown "ChatGPT / Claude'da aç" ve inline try-it.
Oku →API'de Numeroloji: Tek bir rotada 5 hesaplama sistemi
Çoğu API ya hiç numeroloji sunmaz ya da tek bir Pisagor sistemi verir. Bizde 5 tam sistem (Pisagor, Haldik, iki Kabalist, Vedik) her biri 10 hesaplama ile tek bir parametreli rotada. Ayrıca 22 arkanaya yönelik Kader Matrisi.
Oku →Tiplenmiş MCP çıktısı: neden 600+ araç outputSchema'ye sahip
Çoğu MCP sunucusu, ajanına tiplenmemiş JSON döndürür – model yanıt biçimini tahmin etmek zorunda kalır. 600+ araç için katı outputSchema yayınlıyoruz. Nasıl çalıştığını, strict-mode istemcilerinde hangi hatayı açtığını ve açık şemalarla nasıl düzelttiğimizi inceliyoruz.
Oku →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.
Oku →Doğruluğu nasıl kontrol altında tutuyoruz: swetest ve NASA'ya karşı CI
Bir astroloji API'sinde doğruluk, efemeris kodundaki tek bir refactoring ile kolayca bozulabilir. Korumayı inceliyoruz: uygulama ve API için tek bir Swiss Ephemeris çekirdeği, referans haritalar üzerinde yüzlerce dondurulmuş snapshot ve her PR'ın swetest CGI, Kerykeion, Prokerala ve NASA tutulma kataloğuna karşı üçgenlenmesi.
Oku →Üç resmi SDK: ham curl yerine TypeScript, Python, PHP
Ham HTTP çalışır, ama tipli bir istemci saatler kazandırır: yol otomatik tamamlama, istek ve yanıt tipleri, 408/409/429/5xx için yerleşik retry ve Stainless tarzı hata hiyerarşisi. Üç resmi SDK'yı, @astroway/sdk (npm), astroway (PyPI) ve astroway/sdk (Packagist), ve bunların tek bir OpenAPI sözleşmesinden nasıl üretildiğini inceliyoruz.
Oku →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.
Oku →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.
Oku →