Dokumentace AstroWay API

Hlavní dokumentační hub AstroWay API. 761 endpointů založených na Swiss Ephemeris, strojově čitelná OpenAPI specifikace, hotové kolekce pro Postman a Insomnia, oficiální SDK pro TypeScript, Python a PHP, MCP server pro Claude/Cursor.

Reference

API Reference Plný katalog {siteMeta.endpoints} endpointů: parametry, schémy odpovědí, kódy chyb. Generováno z OpenAPI specifikace na každém vydání.

OpenAPI specification Strojově čitelná specifikace. Importujte do Postmanu/Insomnia nebo vygenerujte svůj SDK prostřednictvím openapi-generator.

Postman collection Hotová k importu kolekce s příklady pro každý endpoint.

Per-endpoint cost Cena v kreditech pro každý endpoint - od 0 do 500 kreditech.

Start

Rychlý start Zaregistrovat se, získat klíč, udělat první volání za 5 minut.

Autentifikace X-Api-Key vs Bearer, live (aw_live_*) vs sandbox (aw_test_*), JWT pro dashboard.

Kredity a limity Poulirování kreditech, měsíční kvóty, rate limits podle plánu.

Podpora jazyků 21 aktivních jazyků. Lokalizace odpovědí prostřednictvím `Accept-Language` (textový obsah).

SDK a integrace

TypeScript SDK Oficiální balíček `@astroway/sdk` na npm. ESM, Node 20+, browser-compatible.

Python SDK Oficiální balíček `astroway` na PyPI. Sync a async klienti, Python 3.9+.

PHP SDK Oficiální balíček `astroway/sdk` na Packagist. PSR-18 HTTP, PHP 8.1+.

MCP server `@astroway/mcp` - Model Context Protocol server pro Claude Desktop, Cursor a další AI-agenty.

Inženýrství

Přesnost výpočtů Swiss Ephemeris arc-second přesnost. CI-snapshot testy proti NASA Eclipse Catalog.

Chyby Seznam kódů chyb, HTTP statusů a struktura chybového obalu.

Idempotence `Idempotency-Key` header pro bezpečné retry na POST.

Verze Jak jsme bampovali verze, jak se kompatibilita zlomila, jak číst changelog.

Scénáře a příklady

Přehled produktů Čtyři produktové skupiny - Birth Chart, Human Design, Synastry, Horoscope.

Vedická astronomie 354+ endpointů pro Vedic - Vargas, dashas (8 systémů), Panchang, Shadbala, Yogas, Doshas.

Příklady kódu Hotové snipety pro natální kartu, synastrii, transity, Human Design, MCP.

Použití případů Scénáře integrace pro astrozastosunků, AI-agenty a dating-platformy.