Mérnöki jegyzetek.
A csillagászati efemeridák pontosságáról, számítási architektúráról, MCP protokollról és minden apró részletről, ami nem fér el a dokumentációban.
Dokumentáció, amelyet AI-ügynököknek készítettek, nem csak embereknek
A klasszikus dokumentáció emberi szemekre készült: szép HTML, kódkiemelés, navigáció. De a docs felé irányuló forgalom fele most már ügynökök és asszisztensek, akiknek egyszerű szöveg kell, nem renderelt tartalom. Bemutatjuk, mit adtunk hozzá: minden oldal .md-duplikátuma, llms.txt, géppel olvasható specifikációk, 'megnyitás ChatGPT-ben/Claude-ban' legördülő menü és inline try-it.
Olvasás →Numerológia az API-ban: 5 számítási rendszer egy útvonalon
A legtöbb API vagy egyáltalán nem rendelkezik numerológiával, vagy csak egy pitagórészi rendszert kínál. Nálunk 5 teljes rendszer (pitagórészi, hurrita, két kabalisztikus, védikus) 10 számítással mindegyik, egy paraméterezett útvonalon. Plusz a Sors Mátrix 22 arkánumra.
Olvasás →Tipizált MCP kimenet: miért 600+ eszköznek van outputSchema
A legtöbb MCP-szerver nem tipizált JSON-t ad vissza az ügynöknek – a modellnek ki kell találni a válasz formáját. Közlünk egy szigorú outputSchema-t 600+ eszközhöz. Megvitatjuk, hogyan működik, milyen hibát nyitott meg a strict-mode kliensekben, és hogyan javítottuk ki nyílt sémák segítségével.
Olvasás →Katalógus térkép: hogyan épülnek fel a 700+ AstroWay endpointja
Az API több mint 700 endpointra nőtt 57 csoportban – a születési horoszkóptól a BaZi-ig, a geomanciáig és az SVG-képek rendereléséig. Áttekintjük, hogyan van a katalógus felosztva domainekre, melyik egységes mintát követik az összes hívás, és hogyan találhatjuk meg gyorsan a szükséges endpointot.
Olvasás →Hogyan tartjuk kézben a pontosságot: CI a swetest és a NASA ellen
Egy asztrológiai API pontossága egyetlen efemerisz-refaktorálástól is könnyen leromlik. Bemutatjuk a védelmet: egyetlen Swiss Ephemeris mag az alkalmazásnak és az API-nak, több száz befagyasztott snapshot referenciaképleteken, és minden PR háromszögelése a swetest CGI, a Kerykeion, a Prokerala és a NASA fogyatkozáskatalógusa ellen.
Olvasás →Három hivatalos SDK: TypeScript, Python, PHP a nyers curl helyett
A nyers HTTP működik, de a típusos kliens órákat spórol meg: útvonalak automatikus kiegészítése, kérés és válasz típusai, beépített újrapróbálkozás 408/409/429/5xx hibákra, és Stainless-stílusú hierarchia. Bemutatjuk a három hivatalos SDK-t - @astroway/sdk (npm), astroway (PyPI), astroway/sdk (Packagist) - és hogy hogyan generálódtak egyetlen OpenAPI-szerződésből.
Olvasás →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.
Olvasás →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.
Olvasás →