Dokumentace AstroWay API

Last updated 25. 9. 2026 Zobrazit jako Markdown Nastavení agenta

Rozcestník technické dokumentace AstroWay API. 865 endpointů postavených na Swiss Ephemeris, strojově čitelná OpenAPI specifikace, hotové kolekce pro Postman a Insomnia, oficiální SDK pro TypeScript, Python a PHP a MCP server pro Claude/Cursor.

Reference

API Reference Kompletní katalog 865 endpointů: parametry, schémata odpovědí, chybové kódy. Generuje se z OpenAPI specifikace při každém vydání.

OpenAPI specification Strojově čitelná specifikace. Naimportuj ji do Postmana/Insomnie nebo si vygeneruj vlastní SDK přes openapi-generator.

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

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

Začínáme

Rychlý start Zaregistruj se, získej klíč a udělej první volání za 5 minut.

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

Kredity a limity Sdílení kreditů, měsíční kvóty, rate limity podle tarifu.

Podporované jazyky 21 aktivních jazyků. Lokalizace odpovědí přes `Accept-Language` (textový obsah).

SDK a integrace

TypeScript SDK Oficiální balíček `@astroway/sdk` na npm. ESM, Node 20+, funguje i v prohlížeči.

Python SDK Oficiální balíček `astroway` na PyPI. Synchronní i asynchronní klient, Python 3.9+.

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

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

Inženýrství

Přesnost výpočtů Přesnost Swiss Ephemeris na úrovni obloukových vteřin. CI snapshot testy proti NASA Eclipse Catalog.

Chyby Seznam chybových kódů, HTTP stavů a struktura error envelope.

Idempotency Hlavička `Idempotency-Key` pro bezpečné opakování POST požadavků.

Verzování Jak zvyšujeme verze, co rozbíjí kompatibilitu a jak číst changelog.

Scénáře a příklady

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

Védská astrologie 354+ endpointů pro védskou astrologii: Vargas, dashas (8 systémů), Panchang, Shadbala, Yogas, Doshas.

Ukázky kódu Hotové snippety pro natální horoskop, synastrii, tranzity, Human Design, MCP.

Use cases Integrační scénáře pro astrologické aplikace, AI agenty a seznamovací platformy.

Navrhnout úpravu