Note de inginerie.
Despre precizia efemeridelor, arhitectura calculului, protocolul MCP și toate amănuntele care nu încap în documentație.
Documentație creată pentru agenți AI, nu doar pentru oameni
Documentația clasică este creată pentru ochii umani: HTML frumos, evidențiere cod, navigare. Dar jumătate din traficul către docs acum sunt agenți și asistenți care au nevoie de plain-text, nu de randare. Explorăm ce am adăugat: .md-dublu pentru fiecare pagină, llms.txt, specificații mașină-citabile, dropdown 'deschide în ChatGPT / Claude' și try-it inline.
Citește →Numerologie în API: 5 sisteme de calcul pe un singur traseu
Majoritatea API-urilor nu au deloc numerologie sau oferă doar un sistem pitagoreic. Noi avem 5 sisteme complete (pitagoreic, caldeean, două cabalistice, vedică) cu câte 10 calcule fiecare, pe un singur traseu parametrizat. Plus Matricea Destinului cu 22 de arcani.
Citește →Output MCP tipizat: de ce peste 600 de instrumente au outputSchema
Majoritatea serverelor MCP îi dau agentului JSON netipizat, iar modelul trebuie să ghicească forma răspunsului. Noi publicăm un outputSchema strict pentru peste 600 de instrumente. Explicăm cum funcționează, ce bug a scos la iveală în clienții strict-mode și cum l-am reparat prin scheme deschise.
Citește →Harta catalogului: cum sunt structurate 700+ endpoint-uri AstroWay
API-ul a crescut la peste 700 de endpoint-uri în 57 de grupuri - de la harta natală la BaZi, geomantie și randare de hărți SVG. Analizăm cum este împărțit catalogul în domenii, după ce model unic sunt toate apelurile și cum să găsești rapid endpoint-ul necesar.
Citește →Cum ținem precizia sub control: CI contra swetest și NASA
Precizia unui API de astrologie se degradează ușor după o singură refactorizare a efemeridelor. Explicăm protecția: un singur nucleu Swiss Ephemeris pentru aplicație și API, sute de snapshot-uri înghețate pe hărți de referință și triangularea fiecărui PR contra swetest CGI, Kerykeion, Prokerala și a catalogului de eclipse NASA.
Citește →Trei SDK-uri oficiale: TypeScript, Python și PHP în loc de curl simplu
HTTP-ul simplu funcționează, dar un client tipizat economisește ore: autocompletare pentru căi, tipuri de cerere și răspuns, retry integrat la 408/409/429/5xx și o ierarhie de erori în stil Stainless. Analizăm cele trei SDK-uri oficiale, @astroway/sdk (npm), astroway (PyPI) și astroway/sdk (Packagist), și cum sunt generate dintr-un singur contract OpenAPI.
Citește →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.
Citește →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.
Citește →