Dokumentacja AstroWay API

Last updated 25 wrz 2026 Otwórz jako Markdown Konfiguracja agenta

Centrum dokumentacji technicznej AstroWay API. 781 endpointów opartych na Swiss Ephemeris, specyfikacja OpenAPI czytelna maszynowo, gotowe kolekcje dla Postmana i Insomnii, oficjalne SDK dla TypeScriptu, Pythona i PHP, serwer MCP dla Claude/Cursor.

Dokumentacja referencyjna

API Reference Pełny katalog 781 endpointów: parametry, schematy odpowiedzi, kody błędów. Generowany ze specyfikacji OpenAPI przy każdym wydaniu.

OpenAPI specification Specyfikacja czytelna maszynowo. Zaimportuj ją do Postmana/Insomnii albo wygeneruj własne SDK przez openapi-generator.

Postman collection Gotowa do importu kolekcja z przykładami dla każdego endpointu.

Per-endpoint cost Koszt w kredytach dla każdego endpointu - od 0 do 500 kredytów.

Start

Szybki start Zarejestruj się, wygeneruj klucz i wykonaj pierwsze wywołanie w 5 minut.

Uwierzytelnianie X-Api-Key vs Bearer, live (aw_live_*) vs sandbox (aw_test_*), JWT dla panelu.

Kredyty i limity Pula kredytów, miesięczne limity, rate limits według planu.

Obsługiwane języki 21 aktywnych języków. Lokalizacja odpowiedzi przez `Accept-Language` (treści tekstowe).

SDK i integracje

TypeScript SDK Oficjalny pakiet `@astroway/sdk` w npm. ESM, Node 20+, działa w przeglądarce.

Python SDK Oficjalny pakiet `astroway` w PyPI. Klienty sync i async, Python 3.9+.

PHP SDK Oficjalny pakiet `astroway/sdk` w Packagist. PSR-18 HTTP, PHP 8.1+.

MCP server `@astroway/mcp` - serwer Model Context Protocol dla Claude Desktop, Cursor i innych agentów AI.

Inżynieria

Dokładność obliczeń Precyzja Swiss Ephemeris na poziomie sekundy łuku. Testy snapshotowe w CI względem NASA Eclipse Catalog.

Błędy Lista kodów błędów, statusów HTTP i struktura error envelope.

Idempotency Nagłówek `Idempotency-Key` do bezpiecznego ponawiania żądań POST.

Wersjonowanie Jak podbijamy wersje, co łamie kompatybilność i jak czytać changelog.

Scenariusze i przykłady

Przegląd produktów Cztery grupy produktów - Birth Chart, Human Design, Synastry, Horoscope.

Astrologia wedyjska 354+ endpointy astrologii wedyjskiej - Vargas, dashas (8 systemów), Panchang, Shadbala, Yogas, Doshas.

Przykłady kodu Gotowe snippety dla kosmogramu urodzeniowego, synastrii, tranzytów, Human Design, MCP.

Use cases Scenariusze integracji dla aplikacji astrologicznych, agentów AI i platform randkowych.

Zaproponuj edycję