Technische aantekeningen.
Over de nauwkeurigheid van efemeriden, rekenarchitectuur, MCP-protocol en alle kleine details die niet in de docs passen.
Documentatie gemaakt voor AI-agents, niet alleen voor mensen
Klassieke documentatie is gemaakt voor menselijke ogen: mooie HTML, syntax highlighting, navigatie. Maar de helft van het verkeer naar docs bestaat nu uit agents en assistenten, die plain text nodig hebben en geen rendering. We laten zien wat we hebben toegevoegd: een .md-tweeling van elke pagina, llms.txt, machineleesbare specificaties, een dropdown "openen in ChatGPT / Claude" en inline try-it.
Lees →Numerologie in API: 5 systemen voor berekening via één route
De meeste API's hebben geen numerologie, of bieden één Pythagorees systeem. Wij hebben 5 volledige systemen (Pythagorees, Chaldees, twee Kabbalistische, Vedisch) met elk 10 berekeningen, via één geparametriseerde route. Plus de Matrix van het Lot met 22 arcana.
Lees →Getypeerde MCP-output: waarom 600+ tools outputSchema hebben
De meeste MCP-servers geven een agent niet-getypeerde JSON - het model moet de vorm van de respons raden. We publiceren een strikt outputSchema voor 600+ tools. We bespreken hoe dit werkt, welke bug dit in strict-mode clients heeft geopend en hoe we het hebben opgelost via open schema's.
Lees →Een kaart van de catalogus: zo zijn de 700+ endpoints van AstroWay opgebouwd
De API is gegroeid tot meer dan 700 endpoints in 57 groepen, van geboortehoroscoop tot BaZi, geomantie en het renderen van SVG-horoscopen. We laten zien hoe de catalogus in domeinen is verdeeld, welk ene patroon alle aanroepen volgen en hoe je snel het juiste endpoint vindt.
Lees →Zo houden we de nauwkeurigheid onder controle: CI tegen swetest en NASA
Nauwkeurigheid in een astrologie-API gaat makkelijk achteruit door één refactor van de efemeriden. We laten zien hoe we ons beschermen: één Swiss Ephemeris-kern voor app en API, honderden bevroren snapshots op referentiehoroscopen en triangulatie van elke PR tegen swetest CGI, Kerykeion, Prokerala en de eclipscatalogus van NASA.
Lees →Drie officiële SDK's: TypeScript, Python en PHP in plaats van kale curl
Kale HTTP werkt, maar een getypeerde client scheelt uren: autocompletion van paden, request- en responsetypes, ingebouwde retry bij 408/409/429/5xx en een foutenhiërarchie in Stainless-stijl. We bespreken de drie officiële SDK's, @astroway/sdk (npm), astroway (PyPI) en astroway/sdk (Packagist), en hoe ze uit één OpenAPI-contract worden gegenereerd.
Lees →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.
Lees →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.
Lees →