AstroWay/api v2.326.0 · nl
alle systemen normaal

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.

Nauwkeurigheid is iets waar de gebruiker je stilzwijgend op controleert bij Astrodienst. Als een geboortehoroscoop een boogminuut afwijkt, komt er snel een klacht binnen. En het ergste is dat nauwkeurigheid gemakkelijk onopgemerkt kan worden verbroken: één refactoring in de efemeridecode, en de helft van de endpoints is stilletjes enkele boogseconden verschoven.

Zo voorkomen we dat dit gebeurt.

Planetaire posities worden berekend op onze eigen servers, zonder externe API, met een nauwkeurigheid tot op de boogseconde, geverifieerd met NASA JPL Horizons. De sleutel: onze applicatie en de API hebben één rekenkern, één codebase. Er zijn geen twee implementaties die kunnen afwijken, dus er is niets dat kan afwijken.

Voor datums buiten het hoofdbereik 1800-2399 is er een analytische efemeride, iets grover (ongeveer 0.1″), maar zonder onderbrekingen aan de grenzen.

Elk rekenkundig endpoint heeft een set bevroren snapshots - 888 JSON-fixtures op het moment van deze build. De runner voert het endpoint uit op referentiekaarten en vergelijkt byte voor byte (binnen de tolerantie) met de fixture. Elke afwijking van de planetaire lengte groter dan 5e-5° (0.18″) laat de test falen.

De referentiekaarten zijn zo gekozen dat ze de randgevallen raken, en niet alleen het “gemakkelijke” centrum:

  • Monroe, Diana, Einstein, Bowie - historische kaarten met bekende geboortegegevens
  • polaire breedtegraad - waar huizensystemen degenereren
  • equatoriale - waar ze zich anders gedragen
  • zuidelijk halfrond - controle van spiegeling

De randgevallen vangen precies die regressies op die niet zichtbaar zijn op de kaart van een doorsnee inwoner van Kiev.

Snapshots vangen regressies op ten opzichte van zichzelf. Om de absolute waarheid te controleren, wordt elke release geverifieerd met onafhankelijke bronnen:

Tegen watWat wordt gecontroleerdAfwijking
NASA JPL Horizonsplanetaire posities231 van 231 binnen tolerantie, mediaan 0.052″
swetest CGI (Astrodienst)planetaire lengtes, huizenpunten0.000″
Kerykeion (Python, pyswisseph)onafhankelijke open-source bibliotheek< 0.2″
Prokerala (sidereal Lahiri)siderische posities8-17″, systematisch verschil in ayanamsa-formule, geen engine
NASA 5-Millennium Eclipse Catalogtijd en type verduisteringen< 1 min

De afwijking met Prokerala is geen fout: het zijn verschillende implementaties van de Lahiri-formule, en we documenteren dit expliciet, in plaats van het te verbergen. Met swetest, de referentie-output van Astrodienst, is de drift op deze kaarten nul.

Astrocartografische lijnen worden afzonderlijk geometrisch gecontroleerd - de nauwkeurigheid op de evenaar is beter dan 1.5 km.

Nauwkeurigheid is een CI-gate, geen eenmalige controle:

  • api-accuracy.yml - voert bij elke PR in de backend-code de volledige set snapshots + triangulatie uit. Een rode test blokkeert de merge.
  • check-eclipse-accuracy.yml - vergelijkt eens per jaar verduisteringen met de NASA-catalogus; een afwijking boven de drempel creëert automatisch een issue.

De garantie is eenvoudig: planetaire posities zijn geverifieerd met NASA JPL Horizons, en wijken af van de referentie-output van swetest met een mediaan van 0.0013 boogseconden (maximum 0.561″, Chiron), en deze grens wordt beschermd door automatisering, niet door een belofte in de README. Als er ooit een regressie optreedt, zal deze in onze CI vallen, en niet in de klacht van je gebruiker.

De publieke versie van deze cijfers, met een tabel van afwijkingen voor specifieke kaarten, is te vinden op de pagina Nauwkeurigheid.

MakSeong · AstroWay

I build the AstroWay API: arc-second astrology math on a clean REST surface, and I write about the dull parts that turn out to matter.

// bouw hierop

Posities tot op de boogseconde in 4 regels code.

Gratis sleutel zonder kaart. 5.000 calls per maand tot de eerste betaling.

Meer uit de blog alle berichten →

Engineering 2026-07-15

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.

Industry 2026-06-05

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.

Engineering 2026-06-05

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.