Catalogul AstroWay - sunt deja 758 endpointuri în 57 de grupuri. La o asemenea scară, întrebarea principală a integratorului nu este „dacă acoperirea este suficientă”, ci „cum să nu te pierzi”. Acest articol este o hartă: cum este catalogul împărțit pe domenii și cum să găsești ce ai nevoie în minut.
Un singur model pentru toate apelurile
Section titled “Un singur model pentru toate apelurile”Indiferent de domeniu, fiecare endpoint de calcul are aceeași formă:
POST /v1/{domain}/{calc}X-Api-Key: aw_live_...Content-Type: application/jsonCorpul - JSON cu datele nașterii (dată, oră, coordonate) sau parametri specifici tehnicii. Răspunsul - întotdeauna { "ok": true, "data": {...} } sau { "ok": false, "error": {...} }. Niciun GraphQL, niciun flux de autentificare separat pe domeniu: o cheie în headerul X-Api-Key, un singur format de răspuns.
Asta înseamnă că wrapper‑ul pe care îl scrii pentru harta natală funcționează și pentru BaZi, și pentru rune - se schimbă doar calea și schema corpului.
Domeniile catalogului
Section titled “Domeniile catalogului”Catalogul este grupat în mari domenii. Iată o hartă cu contoarele reale (numerele sunt preluate din manifest la fiecare build, așa că sunt mereu actuale):
| Domeniu | Endpointuri | Ce conține |
|---|---|---|
| Astrologie occidentală | 182 | Hartă natală, aspecte, virtuți, prognoză (tranzite, progresii, direcții), horary, 4 școli elinistice, psihologie modernă, evoluționistă, cosmobiologie |
| Vedică | 174 | Cel mai mare domeniu: nakshatras, dashas, hărți divisional (varga), yogas, dosha, Jaimini, KP, ashtakavarga, shadbala |
| Human Design | 12 | Bodigraph, canale, porți, tip/profil/autoritate, crucea incarnațională |
| Tarot | 66 | Trei pachete: Rider-Waite-Smith, Marseille, Lenormand - aranjamente, semnificații, combinații |
| Numerologie | 50 | 5 sisteme cu 10 calcule fiecare (pitagorică, caldeană, două cabalistice, vedică) |
| Chineză + Maya | 55 | BaZi (patru piloni), Zi Wei Dou Shu, zodiac chinezesc și feng-shui, calendare Maya |
| Divinație | 31 | Geomanție (Agrippa), rune ale Seniorului Futarku, chiromanție (Cheiro), I Ching |
| Nișe aplicative | 51 | Wellness, astrologie animalieră, afaceri, finanțe, familială |
| Rapoarte | 23 | Interpretații gata (natal, sinastrie), în HTML/PDF, cu branding white-label |
| Render | 14 | Roți de hărți SVG/PNG, bodygraph, inele tranzitorii - fără front-end propriu |
| Instrumente Dev | 44 | Webhook-uri, streaming în timp real, widget-uri încorporate, white-label |
Restul - interpretări AI, horoscoape, endpointuri de referință (semne, planete, aspecte) și sistemice (health, usage, openapi).
Vedică - o poveste separată
Section titled “Vedică - o poveste separată”174 endpointuri vedice - reprezintă mai mult decât toată partea occidentală. Motivul e simplu: tradiția vedică este mai formalizată. Unde astrologia occidentală are un singur set de case, vedica are 16 hărți divisional (varga), mai multe sisteme dasha, zeci de yogas cu reguli clare. Fiecare dintre acestea este un endpoint separat cu rezultat determinat.
Dacă construiești pentru piața indiană, acesta este nucleul produsului, nu un supliment.
Precizie sub toate acestea
Section titled “Precizie sub toate acestea”Indiferent de excentricitatea tehnicii, pozițiile planetare sunt calculate de un singur nucleu pe Swiss Ephemeris (WASM). Același nucleu rulează atât în browserul aplicației noastre, cât și pe serverul API - o singură bază de cod, fără discrepanțe. Endpointurile de calcul sunt acoperite de 873 teste snapshot, care la fiecare PR se compară cu sursele de referință. Detalii despre asta - într-un articol separat despre precizia CI.
Cum să găsești ce ai nevoie
Section titled “Cum să găsești ce ai nevoie”Trei căi, de la cea mai rapidă:
- OpenAPI-dosar - /docs/api/ este generat direct din specificația de producție
openapi.json. Grupurile din sidebar = domeniile de mai sus. Fiecare endpoint are schema corpului, un exemplu și butonul „încearcă”. - Catalog MCP - dacă ești în Claude sau Cursor, întregul catalog este disponibil ca set de instrumente prin
mcp.astroway.info. Agentul găsește singur endpointul potrivit pe baza descrierii. - Căutare în specificație -
curl https://api.astroway.info/v1/openapi.jsonreturnează contractul complet mașină-citibil. Convenabil pentru generarea de cod a propriului client.
Începe
Section titled “Începe”Cheia de la dashboard/sign-up oferă 10 000 de credite pe lună - suficient pentru a explora zeci de domenii și a înțelege ce este al tău. Nu trebuie să înveți întregul catalog: ia-ți domeniul și restul va aștepta când vei avea nevoie.
Același Swiss Ephemeris ca în Solar Fire - în 4 linii de cod.
Cheie gratuită fără card. 5.000 de apeluri pe lună până la prima plată.