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

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

## Reference

<CardGrid>
  <LinkCard
    title="API Reference"
    href="/docs/api/"
    description={`Повний каталог ${siteMeta.endpoints} ендпоінтів — параметри, схеми відповідей, коди помилок. Генерується з OpenAPI spec на кожному релізі.`}
  />
  <LinkCard
    title="OpenAPI specification"
    href="https://api.astroway.info/v1/openapi.json"
    description="Машиночитна спека. Імпортуйте в Postman/Insomnia або згенеруйте свій SDK через openapi-generator."
  />
  <LinkCard
    title="Postman collection"
    href="https://api.astroway.info/postman/astroway-api.json"
    description="Готова до імпорту колекція з прикладами для кожного ендпоінту."
  />
  <LinkCard
    title="Per-endpoint cost"
    href="/credits/"
    description="Вартість у кредитах для кожного ендпоінту — від 0 до 500 кредитів."
  />
</CardGrid>

## Старт

<CardGrid>
  <LinkCard
    title="Швидкий старт"
    href="/getting-started/"
    description="Зареєструватись, отримати ключ, зробити перший виклик за 5 хвилин."
  />
  <LinkCard
    title="Автентифікація"
    href="/authentication/"
    description="X-Api-Key vs Bearer, live (aw_live_*) vs sandbox (aw_test_*), JWT для dashboard."
  />
  <LinkCard
    title="Кредити та ліміти"
    href="/rate-limits-credits/"
    description="Пулінг кредитів, місячні квоти, rate limits за планом."
  />
  <LinkCard
    title="Підтримка мов"
    href="/languages/"
    description="21 активна мова. Локалізація відповідей через `Accept-Language` (текстовий контент)."
  />
</CardGrid>

## SDK та інтеграції

<CardGrid>
  <LinkCard
    title="TypeScript SDK"
    href="https://www.npmjs.com/package/@astroway/sdk"
    description="Офіційний пакет `@astroway/sdk` на npm. ESM, Node 20+, browser-сумісний."
  />
  <LinkCard
    title="Python SDK"
    href="https://pypi.org/project/astroway/"
    description="Офіційний пакет `astroway` на PyPI. Sync та async клієнти, Python 3.9+."
  />
  <LinkCard
    title="PHP SDK"
    href="https://packagist.org/packages/astroway/sdk"
    description="Офіційний пакет `astroway/sdk` на Packagist. PSR-18 HTTP, PHP 8.1+."
  />
  <LinkCard
    title="MCP server"
    href="https://www.npmjs.com/package/@astroway/mcp"
    description="`@astroway/mcp` — Model Context Protocol сервер для Claude Desktop, Cursor та інших AI-агентів."
  />
</CardGrid>

## Інженерія

<CardGrid>
  <LinkCard
    title="Точність розрахунків"
    href="/accuracy/"
    description="Swiss Ephemeris arc-second precision. CI-snapshot тести проти NASA Eclipse Catalog."
  />
  <LinkCard
    title="Помилки"
    href="/errors/"
    description="Список error codes, HTTP статусів і структура error envelope."
  />
  <LinkCard
    title="Idempotency"
    href="/idempotency/"
    description="`Idempotency-Key` header для безпечного retry на POST."
  />
  <LinkCard
    title="Версіонування"
    href="/versioning/"
    description="Як ми бампимо версії, що ламає сумісність, як читати changelog."
  />
</CardGrid>

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

<CardGrid>
  <LinkCard
    title="Огляд продуктів"
    href="/products/"
    description="Чотири продуктові групи — Birth Chart, Human Design, Synastry, Horoscope."
  />
  <LinkCard
    title="Ведична астрологія"
    href="/vedic/"
    description="354+ ендпоінти для Vedic — Vargas, dashas (8 систем), Panchang, Shadbala, Yogas, Doshas."
  />
  <LinkCard
    title="Приклади коду"
    href="/examples/"
    description="Готові сніпети для натальної карти, синастрії, транзитів, Human Design, MCP."
  />
  <LinkCard
    title="Use cases"
    href="/use-cases/"
    description="Сценарії інтеграції для астрозастосунків, AI-агентів та дейтинг-платформ."
  />
</CardGrid>