Notatki inżynierskie.
O dokładności efemeryd, architekturze obliczeń, protokole MCP i wszystkich drobiazgach, które nie mieszczą się w docs.
Dokumentacja stworzona dla agentów AI, a nie tylko dla ludzi
Klasyczna dokumentacja powstaje z myślą o ludzkich oczach: ładny HTML, podświetlanie składni, nawigacja. Tymczasem połowa ruchu na docs to dziś agenci i asystenci, którzy potrzebują zwykłego tekstu, a nie wyrenderowanej strony. Opisujemy, co dodaliśmy: wersję .md każdej strony, llms.txt, specyfikacje do odczytu maszynowego, menu "otwórz w ChatGPT / Claude" i wbudowane try-it.
Czytaj →Numerologia w API: 5 systemów obliczeń jednym trasą
Większość API albo w ogóle nie posiada numerologii, albo oferuje jedną system pifagorejski. My mamy 5 pełnych systemów (pifagorejski, chaldejski, dwa kabałistyczne, wedyjski) po 10 obliczeń każdy, jednym parametryzowanym trasą. Plus Macierz Losu na 22 arkana.
Czytaj →Typizowany output MCP: dlaczego 600+ narzędzi ma outputSchema
Większość serwerów MCP zwraca agentowi nieotypizowany JSON - model musi zgadywać formę odpowiedzi. Publikujemy ścisły outputSchema dla 600+ narzędzi. Przeanalizowaliśmy, jak to działa, jaki błąd to otworzyło w klientach w trybie strict i jak go naprawiliśmy przez otwarte schematy.
Czytaj →Mapa katalogu: jak zorganizowane są 700+ endpointów AstroWay
API rozrosło się do ponad 700 endpointów w 57 grupach – od mapy natalnej po BaZi, geomantię i renderowanie map SVG. Analizujemy, jak katalog podzielony jest na domeny, według którego jedyny wzorzec stosują wszystkie wywołania i jak szybko znaleźć potrzebny endpoint.
Czytaj →Jak trzymamy dokładność pod kontrolą: CI kontra swetest i NASA
Dokładność astrologicznego API łatwo zepsuć jednym refaktoringiem efemeryd. Opisujemy zabezpieczenia: jeden rdzeń Swiss Ephemeris dla aplikacji i API, setki zamrożonych snapshotów na horoskopach wzorcowych i triangulacja każdego PR względem swetest CGI, Kerykeion, Prokerala i katalogu zaćmień NASA.
Czytaj →Trzy oficjalne SDK: TypeScript, Python i PHP zamiast surowego curl
Surowe HTTP działa, ale typowany klient oszczędza godziny: podpowiadanie ścieżek, typy żądań i odpowiedzi, wbudowany retry dla 408/409/429/5xx i hierarchia błędów w stylu Stainless. Omawiamy trzy oficjalne SDK - @astroway/sdk (npm), astroway (PyPI), astroway/sdk (Packagist) - i to, jak powstają z jednego kontraktu OpenAPI.
Czytaj →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.
Czytaj →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.
Czytaj →