AstroWay API dokumentáció

Az AstroWay API technikai dokumentációjának központja. 865 végpont a Swiss Ephemeris alapján, gépileg olvasható OpenAPI-specifikáció, kész gyűjtemények Postmanhez és Insomniához, hivatalos SDK-k TypeScripthez, Pythonhoz és PHP-hoz, MCP-szerver Claude-hoz és Cursorhoz.

Referencia

API Reference A(z) 865 végpont teljes katalógusa: paraméterek, válaszsémák, hibakódok. Minden kiadáskor az OpenAPI specből generálódik.

OpenAPI specification Gépileg olvasható specifikáció. Importáld Postmanbe vagy Insomniába, vagy generálj belőle saját SDK-t az openapi-generatorral.

Postman collection Importálásra kész gyűjtemény, minden végponthoz példákkal.

Per-endpoint cost Az egyes végpontok ára kreditben - 0 és 500 kredit között.

Kezdés

Gyors kezdés Regisztrálj, szerezz kulcsot, és indítsd el az első hívást 5 perc alatt.

Hitelesítés X-Api-Key vs Bearer, live (aw_live_*) vs sandbox (aw_test_*), JWT a dashboardhoz.

Kreditek és limitek Kreditpoolozás, havi kvóták, csomagonkénti rate limitek.

Nyelvi támogatás 21 aktív nyelv. A válaszok lokalizálása az `Accept-Language` fejléccel (szöveges tartalom).

SDK-k és integrációk

TypeScript SDK A hivatalos `@astroway/sdk` csomag az npm-en. ESM, Node 20+, böngészőkompatibilis.

Python SDK A hivatalos `astroway` csomag a PyPI-on. Szinkron és aszinkron kliensek, Python 3.9+.

PHP SDK A hivatalos `astroway/sdk` csomag a Packagiston. PSR-18 HTTP, PHP 8.1+.

MCP server `@astroway/mcp` - Model Context Protocol szerver Claude Desktophoz, Cursorhoz és más AI-ügynökökhöz.

Mérnöki háttér

Számítási pontosság Swiss Ephemeris ívmásodperces pontosság. CI-snapshot tesztek a NASA Eclipse Catalog ellen.

Hibák Hibakódok, HTTP-státuszok és az error envelope szerkezete.

Idempotency `Idempotency-Key` fejléc a POST kérések biztonságos újrapróbálásához.

Verziókezelés Hogyan emeljük a verziókat, mi töri a kompatibilitást, hogyan olvasd a changelogot.

Forgatókönyvek és példák

Termékáttekintés Négy termékcsoport - Birth Chart, Human Design, Synastry, Horoscope.

Védikus asztrológia 354+ védikus végpont - Vargas, dashák (8 rendszer), Panchang, Shadbala, jógák, dosák.

Kódpéldák Kész snippetek születési képlethez, szinasztriához, tranzitokhoz, Human Designhoz, MCP-hez.

Use cases Integrációs forgatókönyvek asztrológiai alkalmazásokhoz, AI-ügynökökhöz és társkereső platformokhoz.