Документація AstroWay API

Хаб технічної документації AstroWay API. 723 ендпоінтів на основі Swiss Ephemeris, машиночитна OpenAPI-спека, готові колекції для Postman і Insomnia, офіційні SDK для TypeScript, Python та PHP, MCP-сервер для Claude/Cursor.

Reference

API Reference Повний каталог 723 ендпоінтів — параметри, схеми відповідей, коди помилок. Генерується з 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 та інтеграції

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-агентів.

Інженерія

Точність розрахунків Swiss Ephemeris arc-second precision. CI-snapshot тести проти NASA Eclipse Catalog.

Помилки Список error codes, HTTP статусів і структура error envelope.

Idempotency `Idempotency-Key` header для безпечного retry на POST.

Версіонування Як ми бампимо версії, що ламає сумісність, як читати changelog.

Сценарії та приклади

Огляд продуктів Чотири продуктові групи — Birth Chart, Human Design, Synastry, Horoscope.

Ведична астрологія 354+ ендпоінти для Vedic — Vargas, dashas (8 систем), Panchang, Shadbala, Yogas, Doshas.

Приклади коду Готові сніпети для натальної карти, синастрії, транзитів, Human Design, MCP.

Use cases Сценарії інтеграції для астрозастосунків, AI-агентів та дейтинг-платформ.