# Будуйте на астрологічному API AstroWay

Source: https://astroway.info/developers/
Language: uk
Updated: 2026-05-28

Астрологічний API · v1

700+ ендпоінтів, три власні SDK, точність Swiss Ephemeris. Анонімний тариф - почніть без ключа.

[Отримати безкоштовний ключ](https://api.astroway.info/dashboard/sign-up) Швидкий старт 10K кредитів/міс · без картки

## Швидкий старт

Отримайте щоденний гороскоп без API-ключа:

```
curl "https://api.astroway.info/v1/embed/daily-horoscope?sign=virgo"
```

### Зареєструйте безкоштовний ключ

[Отримати безкоштовний ключ - 10K кредитів/місяць, без картки](https://api.astroway.info/dashboard/sign-up)

### Перший запит із вашим ключем

```
curl -G "https://api.astroway.info/v1/chart" \
-H "X-Api-Key: aw_live_…" \
--data-urlencode "datetime=1990-06-15T14:30:00+03:00" \
--data-urlencode "lat=50.45" --data-urlencode "lon=30.52"
```

Дивіться [тарифи](https://astroway.info/shop/) для лімітів тарифів і вартості кредитів за ендпоінт.

## Автентифікація

Три тарифи. Оберіть свій.

| Тариф | Автентифікація | Ліміти | Водяний знак |
| --- | --- | --- | --- |
| **Анонімний** | без ключа | лише /v1/embed/* · 30 запитів/год на IP | так |
| **Безкоштовний ключ** | `X-Api-Key: aw_live_…` | 10K кредитів/місяць | так |
| **Платний** | `X-Api-Key: aw_live_…` | Indie 50K / Starter 200K / Pro 800K / Business 3.5M | ні (Pro+) |

### Прив’язка до домену

Платні ключі прив’язуються до одного домену під час першого запиту. Змінити його можна самостійно в кабінеті, до 3 разів на місяць. Встановлення WordPress-плагіна автоматично надсилає заголовок X-AstroWay-Site-URL - без зміни коду.

### Обробка помилок

- `401` — відсутній або недійсний X-Api-Key
- `402` — тариф не включає цей ендпоінт (напр. HD-ендпоінт без HD Pack)
- `403` — невідповідність домену (прив’язаний домен ≠ заголовок Origin)
- `429` — перевищено ліміт запитів або вичерпано місячні кредити (встановлено заголовок Retry-After)

## Вбудовані віджети

Прямий iframe - працює на будь-якому HTML-сайті, без JS-завантажувача. Анонімний тариф, 30 запитів/год на IP відвідувача.

### Щоденний гороскоп

```
<iframe src="https://api.astroway.info/v1/embed/daily-horoscope?sign=virgo"
width="100%" height="320" loading="lazy" frameborder="0"></iframe>
```

### Колесо натальної карти

```
<iframe src="https://api.astroway.info/v1/embed/natal-wheel?datetime=1990-06-15T14:30:00%2B03:00&lat=50.45&lon=30.52"
width="600" height="600" loading="lazy" frameborder="0"></iframe>
```

### Карта дня Таро

```
<iframe src="https://api.astroway.info/v1/embed/tarot-daily?deck=rider-waite"
width="400" height="500" loading="lazy" frameborder="0"></iframe>
```

### Фаза Місяця

```
<iframe src="https://api.astroway.info/v1/embed/moon-phase"
width="320" height="320" loading="lazy" frameborder="0"></iframe>
```

### Встановлення на WordPress

Встановіть [плагін AstroWay для WP ↗](https://wordpress.org/plugins/astroway/) - віджети Tier 1 без налаштувань, шорткоди для копіювання, опційний API-ключ для Tier 2/3.

## Офіційні SDK

Три власні SDK. Повна типобезпека, згенеровані з OpenAPI 3.1. Ліцензія MIT. З повторними спробами, ідемпотентні.

### TypeScript / JavaScript

@astroway/sdk · v1.1.0

```
npm install @astroway/sdk
```

```
import { AstroWayClient } from '@astroway/sdk';
const c = new AstroWayClient({ apiKey: process.env.ASTROWAY_KEY });
const chart = await c.natalChart({
datetime: '1990-06-15T14:30:00+03:00',
lat: 50.45, lon: 30.52
});
```

[GitHub ↗](https://github.com/astroway/astroway-typescript) · [npm ↗](https://www.npmjs.com/package/@astroway/sdk)

Node 22+ · ESM · згенеровано з OpenAPI 3.1

### Python

astroway · v1.1.0

```
pip install astroway
```

```
from astroway import AstroWayClient
c = AstroWayClient(api_key="aw_live_…")
chart = c.natal_chart(
datetime="1990-06-15T14:30:00+03:00",
lat=50.45, lon=30.52,
)
```

[GitHub ↗](https://github.com/astroway/astroway-python) · [PyPI ↗](https://pypi.org/project/astroway/)

Python 3.10+ · sync + async · моделі Pydantic · py.typed

### PHP

astroway/sdk · v1.1.0

```
composer require astroway/sdk
```

```
use AstroWay\AstroWayClient;
$c = new AstroWayClient(apiKey: 'aw_live_…');
$chart = $c->natalChart(
datetime: '1990-06-15T14:30:00+03:00',
lat: 50.45, lon: 30.52,
);
```

[GitHub ↗](https://github.com/astroway/astroway-php) · [Packagist ↗](https://packagist.org/packages/astroway/sdk)

PHP 8.2+ · PSR-18 HTTP-клієнт · проміси Guzzle

### WordPress

Сайт на WordPress? Безкоштовний плагін [AstroWay для WordPress ↗](https://wordpress.org/plugins/astroway/) додає натальні карти, гороскопи, Таро, нумерологію та Human Design через шорткоди й блоки Gutenberg - без коду. Працює анонімно або з вашим API-ключем.

```
[astroway_natal date="1990-06-15" time="14:30" lat="50.45" lon="30.52"]
```

### LLM / AI-агенти

Ми публікуємо [/llms.txt ↗](https://api.astroway.info/llms.txt) для виявлення AI-агентами. Сімейство ендпоінтів `/v1/context/*` повертає оптимізований для LLM XML для прямого споживання інтеграціями ChatGPT / Claude / Gemini.

### MCP-сервер (Pro+)

Нативний сервер Model Context Protocol на mcp.astroway.info - підключіть Claude Desktop або будь-який MCP-клієнт, щоб запитувати весь API в діалоговому режимі. Входить у тарифи Pro і Business.