AstroWay API dokumentáció
Az AstroWay API dokumentációs háza 761 végponttal rendelkezik, amelyek a Swiss Ephemerisre épülnek, gépi olvasztással rendelkező OpenAPI-spec, készen álló gyűjtemények a Postman és az Insomnia számára, valamint hivatalos SDK-ek a TypeScript, Python és PHP számára, MCP-szerver a Claude/Cursor számára.
Referencia
Szekció neve “Referencia” API Reference Teljes katalógus a {siteMeta.endpoints} végpontokról: paraméterek, válasz-sémák, hiba-kódok. Az OpenAPI-spec generálásával minden kiadáson.
OpenAPI specification Gépi olvasztású specifikáció. Importálja a Postman/Insomnia-ba vagy generálja a saját SDK-ját az openapi-generator segítségével.
Postman collection Készen álló importálható gyűjtemény minden végponttal.
Per-endpoint cost Az egyes végpontok költsége - 0-tól 500-ig.
Kezdés
Szekció neve “Kezdés” Gyors kezdés Regisztráljon, kapjon kulcsot, és tegyen meg egy első hívást 5 percben.
Azonosítás X-Api-Key vs Bearer, élő (aw_live_*) vs teszt (aw_test_*), JWT a dashboard számára.
Kreditek és korlátozások Kreditek pólása, havi kvóták, rate limits a terv alapján.
Nyelvi támogatás 21 aktív nyelv. A válaszok lokálisítása az `Accept-Language` (szöveges tartalom) fejlécen keresztül.
SDK és integráció
Szekció neve “SDK és integráció” TypeScript SDK Az AstroWay által hivatalosan kiadott `@astroway/sdk` npm csomag. ESM, Node 20+, böngésző-kompatibilis.
Python SDK Az AstroWay által hivatalosan kiadott `astroway` PyPI csomag. Sincronizálás és aszinkronizálás kliensek, Python 3.9+.
PHP SDK Az AstroWay által hivatalosan kiadott `astroway/sdk` Packagist csomag. PSR-18 HTTP, PHP 8.1+.
MCP server Az `@astroway/mcp` - Model Context Protocol szerver a Claude Desktop, Cursor és más AI-ügynökök számára.
Inżynieria
Szekció neve “Inżynieria” Pontosság a számításokban A Swiss Ephemeris arc-másodperc pontosság. CI-snapshot tesztek a NASA Eclipse Catalog ellen.
Hibák Hiba-kódok listája, HTTP státusok és hiba-keretek struktúrája.
Idempotencia Az `Idempotency-Key` fejléc a POST-hívások biztonságos ismétléséhez.
Verziók Miként bámpoljuk a verziókat, milyen kompatibilitási problémákat okoznak, hogyan olvassuk a changelogot.
Szenariók és példák
Szekció neve “Szenariók és példák” Termékvizsgálat Négy termékgát - Születési chart, Emberi tervezés, Szinasztria, Horoszkóp.
Védikus asztrológia 354+ végpont a Védikus - Vargas, dashas (8 rendszer), Panchang, Shadbala, Yogas, Doshas.
Példák kód Készen álló példák a natális chart, szinasztria, transzitok, emberi tervezés, MCP számára.
Használati esetek Integrációs szenariók az asztrozastamok, AI-ügynökök és dátumozási platformok számára.
Hasznos volt?
Köszönjük a visszajelzést.