Inženýrské poznámky.
O přesnosti efemerid, architektuře výpočtů, MCP protokolu a všech drobnostech, které se nevejdou do docs.
Dokumentace vytvořená pro AI agenty, nejen pro lidi
Klasická dokumentace je vytvořena pro lidské oči: pěkný HTML, zvýraznění kódu, navigace. Ale polovina provozu k docs je nyní – agenti a asistenti, kteří potřebují plain-text, ne render. Rozebíráme, co jsme přidali: .md dvojník každé stránky, llms.txt, strojově čitelné specifikace, dropdown "otevřít v ChatGPT / Claude" a inline try-it.
Číst →Numerologie v API: 5 systémů výpočtu jednou cestou
Většina API buď vůbec nemá numerologii, nebo poskytuje jen jeden pythagorejský systém. My máme 5 kompletních systémů (pythagorejský, chaldejský, dva kabalistické, védický) po 10 výpočtech každý, jednou parametrizovanou cestou. Plus Matice Osudu na 22 arkánů.
Číst →Typovaný výstup MCP: proč 600+ nástrojů má outputSchema
Většina MCP serverů vrací agentovi netypizovaný JSON - model musí hádat strukturu odpovědi. Publikujeme striktní outputSchema pro 600+ nástrojů. Analyzujeme, jak to funguje, jakou chybu to odhalilo v strict-mode klientech a jak jsme ji opravili pomocí otevřených schémat.
Číst →Mapa katalogu: jak jsou uspořádány 700+ endpointů AstroWay
API vyrostlo na více než 700 endpointů ve 57 skupinách – od natalního chartu po BaZi, geomancii a renderování SVG map. Rozebíráme, jak je katalog rozdělen do domén, podle kterých všechny volání používají jednotný vzor, a jak rychle najít požadovaný endpoint.
Číst →Jak držíme přesnost pod kontrolou: CI proti swetest a NASA
Přesnost astro API snadno utrpí jediným refaktoringem efemerid. Rozebíráme ochranu: jedno jádro Swiss Ephemeris pro aplikaci i API, stovky zmrazených snapshotů na referenčních horoskopech a triangulace každého PR proti swetest CGI, Kerykeion, Prokerala a katalogu zatmění NASA.
Číst →Tři oficiální SDK: TypeScript, Python, PHP místo holého curl
Holé HTTP funguje, ale typovaný klient ušetří hodiny: doplňování cest, typy požadavku i odpovědi, vestavěný retry na 408/409/429/5xx a hierarchie chyb ve stylu Stainless. Rozebíráme tři oficiální SDK, @astroway/sdk (npm), astroway (PyPI) a astroway/sdk (Packagist), a to, jak se generují z jednoho OpenAPI kontraktu.
Číst →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.
Číst →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.
Číst →