Документація AstroWay API
Хаб технічної документації AstroWay API. 781 ендпоінтів на основі Swiss Ephemeris, машиночит��а OpenAPI-спека, готові колекції для Postman і Insomnia, офіційні SDK для TypeScript, Python та PHP, MCP-сервер для Claude/Cursor.
Reference
Section titled “Reference” API Reference Повний каталог 781 ендпоінтів: параметри, схеми відповідей, коди помилок. Генерується з OpenAPI spec на кожному релізі.
OpenAPI specification Машиночитна спека. Імпортуйте в Postman/Insomnia або згенеруйте свій SDK через openapi-generator.
Postman collection Готова до імпорту колекція з прикладами для кожного ендпоінту.
Per-endpoint cost Вартість у кредитах для кожного ендпоінту - від 0 до 500 кредитів.
Швидкий старт Зареєструватись, отримати ключ, зробити перший виклик за 5 хвили��.
Автентифікація X-Api-Key vs Bearer, live (aw_live_*) vs sandbox (aw_test_*), JWT для dashboard.
Кредити та ліміти Пулінг кредитів, місячні квоти, rate limits за планом.
Підтримка мов 21 активна мова. Локалізація відповідей через `Accept-Language` (текстовий контент).
SDK та інтеграції
Section titled “SDK та інтеграції” TypeScript SDK Офіційний пакет `@astroway/sdk` на npm. ESM, Node 20+, browser-сумісний.
Python SDK Офіційний пакет `astroway` на PyPI. Sync та async клієнти, Python 3.9+.
PHP SDK Офіційний пакет `astroway/sdk` на Packagist. PSR-18 HTTP, PHP 8.1+.
MCP server `@astroway/mcp` - Model Context Protocol сервер для Claude Desktop, Cursor та інших AI-агентів.
Інженерія
Section titled “Інженерія” Точність розрахунків Swiss Ephemeris arc-second precision. CI-snapshot тести проти NASA Eclipse Catalog.
Помилки Список error codes, HTTP статусів і структура error envelope.
Idempotency `Idempotency-Key` header для безпечного retry на POST.
Версіонування Як ми бампимо версії, що ламає сумісність, як читати changelog.
Сценарії та приклади
Section titled “Сценарії та приклади” Огляд продуктів Чотири продуктові групи - Birth Chart, Human Design, Synastry, Horoscope.
Ведична астрологія 354+ ендпоінти для Vedic - Vargas, dashas (8 систем), Panchang, Shadbala, Yogas, Doshas.
Приклади коду Готові сніпети для натальної карти, синастрії, транзитів, Human Design, MCP.
Use cases Сценарії інтеграції для астрозастосунків, AI-агентів та дейтинг-платформ.